home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 December / 2004-12 CHIP.iso / CHIP / Porady / Srodowisko PHP-MySQL / WAMP5 1.3 / wamp5_1.3.exe / {app} / www / phpmyadmin / Documentation.txt < prev    next >
Text File  |  2004-09-24  |  139KB  |  2,901 lines

  1.  
  2.    ______________________________________________________________________
  3.  
  4.    Top    -    Requirements    -    Introduction    -    Installation   -
  5.    Configuration
  6.    Transformations  -  FAQ  -  Developers  -  Credits  -  Translators
  7.    ______________________________________________________________________
  8.  
  9.                       phpMyAdmin 2.6.0-rc3 Documentation
  10.  
  11.      * SourceForge phpMyAdmin project page   [ http://www.phpmyadmin.net/
  12.        ] 
  13.      * Local documents:
  14.           + Version history: ChangeLog
  15.           + General notes: README
  16.           + License: LICENSE
  17.      * Documentation  version:  $Id: Documentation.html,v 2.84 2004/09/20
  18.        17:55:35 lem9 Exp $
  19.  
  20. Requirements
  21.  
  22.      * php 4.1.0 or later (*)
  23.        If  you  want  to  display  inline  thumbnails  of  JPEGs with the
  24.        original aspect ratio, you also need GD2 support in PHP.
  25.      * MySQL 3.23.32 or newer (details);
  26.      * a web-browser (doh!).
  27.  
  28. Introduction
  29.  
  30.    phpMyAdmin  can  manage  a  whole MySQL server (needs a super-user) as
  31.    well  as  a  single  database.  To accomplish the latter you'll need a
  32.    properly  set  up  MySQL  user  who  can  read/write  only the desired
  33.    database.  It's up to you to look up the appropriate part in the MySQL
  34.    manual.
  35.    Currently phpMyAdmin can:
  36.      * create and drop databases
  37.      * create, copy, drop, rename and alter tables
  38.      * do table maintenance
  39.      * delete, edit and add fields
  40.      * execute any SQL-statement, even batch-queries
  41.      * manage keys on fields
  42.      * load text files into tables
  43.      * create (*) and read dumps of tables
  44.      * export (*) data to CSV, XML and Latex formats
  45.      * administer multiple servers
  46.      * manage MySQL users and privileges
  47.      * check referential integrity in MyISAM tables
  48.      * using Query-by-example (QBE), create complex queries automatically
  49.        connecting required tables
  50.      * create PDF graphics of your Database layout
  51.      * search globally in a database or a subset of it
  52.      * transform  stored  data  into any format using a set of predefined
  53.        functions,  like displaying BLOB-data as image or download-link or
  54.        ...
  55.      * support InnoDB tables and foreign keys (see FAQ 3.6)
  56.      * support mysqli, the improved MySQL extension (see FAQ 1.17)
  57.      * communicate in 47 different languages
  58.  
  59.    (*)   phpMyAdmin  can compress (Zip, GZip -RFC 1952- or Bzip2 formats)
  60.    dumps  and  CSV  exports  if  you  use PHP4 >= 4.0.4 with Zlib support
  61.    (--with-zlib) and/or Bzip2 support (--with-bz2).
  62.  
  63. Installation
  64.  
  65.    NOTE:  phpMyAdmin  does  not apply any special security methods to the
  66.    MySQL  database  server. It is still the system administrator's job to
  67.    grant  permissions  on  the  MySQL  databases  properly.  phpMyAdmin's
  68.    "Privileges" page can be used for this.
  69.  
  70.    Warning  for  Mac  users:if  you  are  on a MacOS version before OS X,
  71.    StuffIt unstuffs with Mac formats.
  72.    So  you'll  have  to  resave as in BBEdit to Unix style ALL phpMyAdmin
  73.    scripts before uploading them to your server, as PHP seems not to like
  74.    Mac-style end of lines character ("\r").
  75.  
  76.   Quick Install
  77.  
  78.     1. Untar   or   unzip   the   distribution  (be  sure  to  unzip  the
  79.        subdirectories):   tar   -xzvf   phpMyAdmin_x.x.x.tar.gz  in  your
  80.        webserver's document root. If you don't have direct access to your
  81.        document root, put the files in a directory on your local machine,
  82.        and,  after  step  3,  transfer  the  directory on your web server
  83.        using, for example, ftp.
  84.     2. Ensure  that all the scripts have the appropriate owner (if PHP is
  85.        running  in safe mode, having some scripts with an owner different
  86.        from  the  owner  of other scripts will be a problem). See FAQ 4.2
  87.        for suggestions.
  88.     3. Open  the  file  config.inc.php in your favorite editor and change
  89.        the values for host, user, password and authentication mode to fit
  90.        your environment. Here, "host" means the MySQL server. Also insert
  91.        the  correct  value  for  $cfg['PmaAbsoluteUri'].  Have  a look at
  92.        Configuration section for an explanation of all values.
  93.     4. It  is  recommended  that  you  protect the directory in which you
  94.        installed  phpMyAdmin  (unless  it's  on a closed intranet, or you
  95.        wish  to  use  HTTP  or  cookie  authentication), for example with
  96.        HTTP-AUTH (in a .htaccess file). See the multi-user sub-section of
  97.        the FAQ for additional information, especially FAQ 4.4.
  98.     5. Open  the file <www.your-host.com>/<your-install-dir>/index.php in
  99.        your  browser.  phpMyAdmin should now display a welcome screen and
  100.        your  databases,  or  a  login  dialog  if  using  HTTP  or cookie
  101.        authentication mode.
  102.  
  103.   Linked-tables infrastructure
  104.  
  105.    For  a  whole  set  of new features (bookmarks, comments, SQL-history,
  106.    PDF-generation,  field  contents  transformation,  etc.)  you  need to
  107.    create  a  set  of special tables. Those tables can be located in your
  108.    own  database,  or in a central database for a multi-user installation
  109.    (this  database would then be accessed by the controluser, so no other
  110.    user should have rights to it).
  111.    Please  look  at your scripts/ directory, where you should find a file
  112.    called  create_tables.sql.  (If  you  are  using a Windows server, pay
  113.    special attention to FAQ 1.23).
  114.    If  your  MySQL  server's  version  is  4.1.2  or  later,  please  use
  115.    create_tables_mysql_4_1_2+.sql instead, for a new installation.
  116.    If  you already had this infrastructure and upgraded to MySQL 4.1.2 or
  117.    later, please use upgrade_tables_mysql_4_1_2+.sql.
  118.    You  can  use  your phpMyAdmin to create the tables for you. Please be
  119.    aware  that  you may need special (administrator) privileges to create
  120.    the  database  and  tables,  and that the script may need some tuning,
  121.    depending on the database name.
  122.    After  having  imported the create_tables.sql file, you should specify
  123.    the  table  names in your config.inc.php file. The directives used for
  124.    that  can be found in the Configuration section. You will also need to
  125.    have a controluser with the proper rights to those tables (see section
  126.    Using authentication modes below).
  127.  
  128.   Upgrading from an older version
  129.  
  130.      * You  can  safely copy your older config.inc.php over a new one, if
  131.        you  can live with default values for possible new parameters (you
  132.        can check release notes to see what new features were added). This
  133.        compatibility  will  stay  for long time, current version supports
  134.        importing  config  files from 2.2 and maybe even older (nobody has
  135.        tried that).
  136.  
  137.   Using authentication modes
  138.  
  139.      * HTTP   and  cookie  authentication  modes  are  recommended  in  a
  140.        multi-user  environment  where  you  want  to give users access to
  141.        their own database and don't want them to play around with others.
  142.        Nevertheless be aware that MS Internet Explorer seems to be really
  143.        buggy  about  cookies,  at  least till version 6. And PHP 4.1.1 is
  144.        also a bit buggy in this area!
  145.        Even in a single-user environment, you might prefer to use HTTP or
  146.        cookie  mode  so  that your user/password pair are not in clear in
  147.        the configuration file.
  148.      * HTTP  and  cookie  authentication modes are more secure: the MySQL
  149.        password  does  not need to be set in the phpMyAdmin configuration
  150.        file   (except   for  the  "controluser"  -see  the  Configuration
  151.        section).
  152.        However,  keep  in  mind  that the password travels in plain text,
  153.        unless you are using the HTTPS protocol.
  154.        In  cookie  mode,  the  password  is  stored,  encrypted  with the
  155.        blowfish algorithm, in a temporary cookie.
  156.      * For 'HTTP' and 'cookie' modes, phpMyAdmin needs a controluser that
  157.        has  only  the  SELECT  privilege  on  the mysql.user (all columns
  158.        except   "Password"),  mysql.db  (all  columns),  mysql.host  (all
  159.        columns)  and  mysql.tables_priv  (all  columns except "Grantor" &
  160.        "Timestamp") tables.
  161.        You   must   specify  the  details  for  the  controluser  in  the
  162.        config.inc.php  file under the $cfg['Servers'][$i]['controluser']&
  163.        $cfg['Servers'][$i]['controlpass'] settings.
  164.        The  following  example  assumes  you  want  to  use  pma  as  the
  165.        controluser  and  pmapass  as the controlpass, but this is only an
  166.        example: use something else in your file!
  167.        Of course you have to replace localhost by the webserver's host if
  168.        it's not the same as the MySQL server's one.
  169.  
  170. GRANT USAGE ON mysql.* TO 'pma'@'localhost' IDENTIFIED BY 'pmapass';
  171. GRANT SELECT (
  172.     Host, User, Select_priv, Insert_priv, Update_priv, Delete_priv,
  173.     Create_priv, Drop_priv, Reload_priv, Shutdown_priv, Process_priv,
  174.     File_priv, Grant_priv, References_priv, Index_priv, Alter_priv,
  175.     Show_db_priv, Super_priv, Create_tmp_table_priv, Lock_tables_priv,
  176.     Execute_priv, Repl_slave_priv, Repl_client_priv
  177.     ) ON mysql.user TO 'pma'@'localhost';
  178. GRANT SELECT ON mysql.db TO 'pma'@'localhost';
  179. GRANT SELECT ON mysql.host TO 'pma'@'localhost';
  180. GRANT SELECT (Host, Db, User, Table_name, Table_priv, Column_priv)
  181.     ON mysql.tables_priv TO 'pma'@'localhost';
  182.  
  183.        If  you  are  using  an  old  MySQL  version (below 4.0.2), please
  184.        replace the first GRANT SELECT query by this one:
  185.  
  186. GRANT SELECT (
  187.     Host, User, Select_priv, Insert_priv, Update_priv, Delete_priv,
  188.     Create_priv, Drop_priv, Reload_priv, Shutdown_priv, Process_priv,
  189.     File_priv, Grant_priv, References_priv, Index_priv, Alter_priv
  190.     ) ON mysql.user TO 'pma'@'localhost';
  191.  
  192.        ...  and  if  you  want  to use the many new relation and bookmark
  193.        features:
  194.  
  195. GRANT SELECT, INSERT, UPDATE, DELETE ON <pma_db>.* TO 'pma'@'localhost';
  196.  
  197.        (this  of course requires you to have a special DB for phpMyAdmin,
  198.        the contents will be explained later)
  199.        Of  course,  the  above  queries  only  work if your MySQL version
  200.        supports the GRANT command. This is the case since 3.22.11.
  201.      * Then  each of the true users should be granted a set of privileges
  202.        on  a  set  of  particular  databases. Normally you shouldn't give
  203.        global  privileges  to an ordinary user, unless you understand the
  204.        impact  of  those  privileges  (for  example,  you  are creating a
  205.        superuser).
  206.        For  example,  to  grant the user real_user with all privileges on
  207.        the database user_base:
  208.           GRANT  ALL  PRIVILEGES  ON user_base.* TO 'real_user'@localhost
  209.        IDENTIFIED BY 'real_password';
  210.        What  the user may now do is controlled entirely by the MySQL user
  211.        management system.
  212.        With  HTTP  or  cookie authentication mode, you don't need to fill
  213.        the user/password fields inside the $cfg['Servers'] array.
  214.  
  215.     'http' authentication mode
  216.  
  217.      * Was called 'advanced' in versions before 2.2.3.
  218.      * Introduced  in 1.3.0, it uses Basic HTTP authentication method and
  219.        allows you to login as any valid MySQL user.
  220.      * Is  only  supported with PHP running as an Apache module, not with
  221.        CGI.
  222.      * See  also  FAQ  4.4  about not using the .htaccess mechanism along
  223.        with 'http' authentication mode.
  224.  
  225.     'cookie' authentication mode
  226.  
  227.      * You   can   use   this  method  as  a  replacement  for  the  HTTP
  228.        authentication (for example, if you're running IIS).
  229.      * Obviously, the user must enable cookies in the browser.
  230.      * With  this mode, the user can truly logout of phpMyAdmin and login
  231.        back with the same username.
  232.      * If    you    want    to    login    to    arbitrary   server   see
  233.        $cfg['AllowArbitraryServer'] directive.
  234.  
  235.     'config' authentication mode
  236.  
  237.      * This  mode  is the less secure one because it requires you to fill
  238.        the $cfg['Servers'][$i]['user'] and
  239.        $cfg['Servers'][$i]['password'] fields.
  240.        But  you  don't  need  to  setup  a  "controluser" here: using the
  241.        $cfg['Servers'][$i]['only_db'] might be enough.
  242.      * In  the  ISP  FAQ  section,  there  is  an entry explaining how to
  243.        protect your configuration file.
  244.      * For additional security in this mode, you may wish to consider the
  245.        Host  authentication $cfg['Servers'][$i]['AllowDeny']['order'] and
  246.        $cfg['Servers'][$i]['AllowDeny']['rules']            configuration
  247.        directives.
  248.  
  249. Configuration
  250.  
  251.    Warning  for  Mac  users:  PHP  seems  not  to  like  Mac end of lines
  252.    character  ("\r").  So ensure you choose the option that allows to use
  253.    the  *nix  end  of  line  character  ("\n") in your text editor before
  254.    registering a script you have modified.
  255.  
  256.    Configuration   note:  Almost  all  configurable  data  is  placed  in
  257.    config.inc.php.  The  parameters  which relate to design (like colors)
  258.    are  placed in themes/themename/layout.inc.php. You might also want to
  259.    modify  config.footer.inc.php  and  config.header.inc.php files to add
  260.    your site specific code to be included on start and end of each page.
  261.  
  262.    $cfg['PmaAbsoluteUri'] string
  263.           Sets  here the complete URL (with full path) to your phpMyAdmin
  264.           version. E.g.
  265.           http://www.your_web.net/path_to_your_phpMyAdmin_directory/.
  266.           phpMyAdmin  needs  this setting, because of requirements of the
  267.           HTTP protocol, explained in RFC2616, section 14.30.
  268.           Don't  forget  the  slash  at the end of your URL. The URL must
  269.           contain  characters  that  are  valid  for  a  URL, and on some
  270.           servers, the path is case-sensitive.
  271.           Starting  with  version  2.3.0,  you  can  try  to  leave  this
  272.           parameter  empty,  because the program tries to auto-detect its
  273.           proper value. Additional details are in the configuration file.
  274.  
  275.    $cfg['PmaAbsoluteUri_DisableWarning'] boolean
  276.           By  default,  when  you leave $cfg['PmaAbsoluteUri'] empty, and
  277.           the  system detects your absolute URI automatically, we display
  278.           a  warning  to  remind  you.  If  you have tested the automatic
  279.           detection,  and it works perfectly for your setup, then you can
  280.           set this variable to squelch the warning.
  281.  
  282.    $cfg['PmaNoRelation_DisableWarning'] boolean
  283.           Starting with version 2.3.0 phpMyAdmin offers a lot of features
  284.           to    work    with    master    /   foreign   -   tables   (see
  285.           $cfg['Servers'][$i]['pmadb']).
  286.           If  you tried to set this up and it does not work for you, have
  287.           a  look on the "Structure" page of one database where you would
  288.           like  to  use  it.  You  will find a link that will analyze why
  289.           those features have been disabled.
  290.           If  you  do not want to use those features set this variable to
  291.           TRUE to stop this message from appearing.
  292.  
  293.    $cfg['blowfish_secret'] string
  294.           Starting  with  version  2.5.2,  the  'cookie'  auth_type  uses
  295.           blowfish algorithm to encrypt the password.
  296.           If  at  least one server configuration uses 'cookie' auth_type,
  297.           enter  here  a  passphrase  of your choice that will be used by
  298.           blowfish.
  299.  
  300.    $cfg['Servers'] array
  301.           Since  version 1.4.2, phpMyAdmin supports the administration of
  302.           multiple  MySQL servers. Therefore, a $cfg['Servers']-array has
  303.           been  added  which  contains  the  login  information  for  the
  304.           different   servers.   The   first  $cfg['Servers'][$i]['host']
  305.           contains   the   hostname  of  the  first  server,  the  second
  306.           $cfg['Servers'][$i]['host']  the hostname of the second server,
  307.           etc.  If  you  have only one server to administer, simply leave
  308.           free the hostname of the other $cfg['Server']-entries.
  309.  
  310.    $cfg['Servers'][$i]['host'] string
  311.           The  hostname  or  IP  address of your $i-th MySQL-server. E.g.
  312.           localhost.
  313.  
  314.    $cfg['Servers'][$i]['port'] string
  315.           The  port-number  of  your  $i-th MySQL-server. Default is 3306
  316.           (leave  blank).  If  you use "localhost" as the hostname, MySQL
  317.           ignores  this  port  number and connects with the socket, so if
  318.           you  want to connect to a port different from the default port,
  319.           use "127.0.0.1" or the real hostname in
  320.           $cfg['Servers'][$i]['host'].
  321.  
  322.    $cfg['Servers'][$i]['socket'] string
  323.           The path to the socket to use. Leave blank for default.
  324.           To use the socket feature you must run PHP 3.0.10 or more.
  325.  
  326.    $cfg['Servers'][$i]['connect_type'] string
  327.           What type connection to use with the MySQL server. Your options
  328.           are  'socket'  &  'tcp'. It defaults to 'tcp' as that is nearly
  329.           guaranteed  to be available on all MySQL servers, while sockets
  330.           are not supported on some platforms.
  331.           To  use  the socket mode, your MySQL server must be on the same
  332.           machine as the Web server.
  333.  
  334.    $cfg['Servers'][$i]['extension'] string
  335.           What  php  MySQL  extension  to  use  for the connection. Valid
  336.           options are:
  337.           mysql :   The  classic MySQL extension. This is the recommended
  338.           and default method at this time.
  339.           mysqli :   The  improved MySQL extension. This extension became
  340.           available  with php 5.0.0 and is the recommended way to connect
  341.           to a server running MySQL 4.1.x.
  342.           Note: phpMyAdmin's MySQL 4.1 support is experimental!
  343.  
  344.    $cfg['Servers'][$i]['compress'] boolean
  345.           Whether  to  use  a  compressed  protocol  for the MySQL server
  346.           connection or not (experimental).
  347.           This feature requires PHP >= 4.3.0.
  348.  
  349.    $cfg['Servers'][$i]['controluser'] string
  350.           $cfg['Servers'][$i]['controlpass'] string
  351.           This  special  account is used for 2 distinct purposes: to make
  352.           possible    a   multi-user   installation   (http   or   cookie
  353.           authentication  mode) and also for all relational features (see
  354.           $cfg['Servers'][$i]['pmadb']).
  355.           When  using  HTTP  or  cookie authentication modes (or 'config'
  356.           authentication mode since phpMyAdmin 2.2.1), you need to supply
  357.           the details of a MySQL account that has SELECT privilege on the
  358.           mysql.user  (all  columns  except  "Password"),  mysql.db  (all
  359.           columns)  &  mysql.tables_priv  (all columns except "Grantor" &
  360.           "Timestamp")  tables.  This  account  is  used  to  check  what
  361.           databases the user will see at login.
  362.           Please  see the install section on "Using authentication modes"
  363.           for more information.
  364.           Note   that   if   you   try  login  to  phpMyAdmin  with  this
  365.           "controluser",  you  could get some errors, depending the exact
  366.           privileges  you  gave to the "controluser". phpMyAdmin does not
  367.           support a direct login with the "controluser".
  368.           In versions before 2.2.5, those were called "stduser/stdpass".
  369.  
  370.    $cfg['Servers'][$i]['auth_type'] string ['http'|'cookie'|'config']
  371.           Whether  config or cookie or http authentication should be used
  372.           for this server.
  373.  
  374.           + 'config'  authentication ($auth_type = 'config') is the plain
  375.             old way: username and password are stored in config.inc.php.
  376.           + 'cookie'   authentication   mode  ($auth_type = 'cookie')  as
  377.             introduced  in  2.2.3 allows you to log in as any valid MySQL
  378.             user  with  the  help  of  cookies. Log name and password are
  379.             stored  in cookies during the session and password is deleted
  380.             when  it  ends. This can also allow you to login in arbitrary
  381.             server if $cfg['AllowArbitraryServer'] enabled.
  382.           + 'http'   authentication   (was  called  'advanced'  in  older
  383.             versions) ($auth_type = 'http') as introduced in 1.3.0 allows
  384.             you to log in as any valid MySQL user via HTTP-Auth.
  385.  
  386.           Please  see the install section on "Using authentication modes"
  387.           for more information.
  388.  
  389.    $cfg['Servers'][$i]['user'] string
  390.           $cfg['Servers'][$i]['password'] string
  391.           The  user/password-pair which phpMyAdmin will use to connect to
  392.           this  MySQL-server.  This user/password pair is not needed when
  393.           HTTP or cookie authentication is used, and should be empty.
  394.  
  395.    $cfg['Servers'][$i]['only_db'] string or array
  396.           If  set  to a (an array of) database name(s), only this (these)
  397.           database(s)  will be shown to the user. Since phpMyAdmin 2.2.1,
  398.           this/these  database(s)  name(s)  may  contain  MySQL wildcards
  399.           characters  ("_" and "%"): if you want to use literal instances
  400.           of  these  characters,  escape  them (I.E. use 'my\_db' and not
  401.           'my_db').
  402.           This setting is an efficient way to lower the server load since
  403.           the  latter  does  not need to send MySQL requests to build the
  404.           available database list. But it does not replace the privileges
  405.           rules  of the MySQL database server. If set, it just means only
  406.           these  databases  will  be  displayed  but  not  that all other
  407.           databases can't be used.
  408.           An    example    of    using    more    that    one   database:
  409.           $cfg['Servers'][$i]['only_db'] = array('db1', 'db2');
  410.           As  of  phpMyAdmin 2.5.5 the order inside the array is used for
  411.           sorting  the  databases  in  the  left  frame,  so that you can
  412.           individually arrange your databases.
  413.           If  you  want  to  have certain databases at the top, but don't
  414.           care  about  the  others,  you do not need to specify all other
  415.           databases.  Use:  $cfg['Servers'][$i]['only_db'] = array('db3',
  416.           'db4',  '*'); instead to tell phpMyAdmin that it should display
  417.           db3 and db4 on top, and the rest in alphabetic order.
  418.  
  419.    $cfg['Servers'][$i]['verbose'] string
  420.           Only useful when using phpMyAdmin with multiple server entries.
  421.           If  set,  this string will be displayed instead of the hostname
  422.           in  the  pull-down menu on the main page. This can be useful if
  423.           you  want  to  show  only certain databases on your system, for
  424.           example.
  425.  
  426.    $cfg['Servers'][$i]['pmadb'] string
  427.           The   name   of   the  database  containing  the  linked-tables
  428.           infrastructure.
  429.           See  the  Linked-tables infrastructure section in this document
  430.           to see the benefits of this infrastructure, and for a quick way
  431.           of creating this database and the needed tables.
  432.           If  you  are the only user of this phpMyAdmin installation, you
  433.           can use your current database to store those special tables; in
  434.           this   case,   just   put   your   current   database  name  in
  435.           $cfg['Servers'][$i]['pmadb'].  For  a  multi-user installation,
  436.           set  this  parameter  to  the  name  of  your  central database
  437.           containing the linked-tables infrastructure.
  438.  
  439.    $cfg['Servers'][$i]['bookmarktable'] string
  440.           Since release 2.2.0 phpMyAdmin allows to bookmark queries. This
  441.           can be useful for queries you often run.
  442.           To allow the usage of this functionality:
  443.  
  444.           + set up pmadb and the linked-tables infrastructure
  445.           + enter the table name in $cfg['Servers'][$i]['bookmarktable']
  446.  
  447.    $cfg['Servers'][$i]['relation'] string
  448.           Since  release  2.2.4 you can describe, in a special 'relation'
  449.           table,  which  field is a key in another table (a foreign key).
  450.           phpMyAdmin currently uses this to
  451.  
  452.           + make  clickable,  when  you browse the master table, the data
  453.             values that point to the foreign table;
  454.           + display  in  an  optional  tool-tip  the "display field" when
  455.             browsing  the master table, if you move the mouse to a column
  456.             containing a foreign key (use also the 'table_info' table);
  457.             (see FAQ 6.7)
  458.           + in  edit/insert  mode,  display  a drop-down list of possible
  459.             foreign keys (key value and "display field" are shown)
  460.             (see FAQ 6.21)
  461.           + display   links  on  the  table  properties  page,  to  check
  462.             referential integrity (display missing foreign keys) for each
  463.             described key;
  464.           + in query-by-example, create automatic joins (see FAQ 6.6)
  465.           + enable  you  to  get a PDF schema of your database (also uses
  466.             the table_coords table).
  467.  
  468.           The keys can be numeric or character.
  469.           To allow the usage of this functionality:
  470.  
  471.           + set up pmadb and the linked-tables infrastructure
  472.           + put the relation table name in
  473.             $cfg['Servers'][$i]['relation']
  474.           + now  as  normal user open phpMyAdmin and for each one of your
  475.             tables   where   you   want   to   use  this  feature,  click
  476.             "Structure/Relation view/" and choose foreign fields.
  477.  
  478.           Please  note that in the current version, master_db must be the
  479.           same  as  foreign_db.  Those  fields  have  been  put in future
  480.           development of the cross-db relations.
  481.  
  482.    $cfg['Servers'][$i]['table_info'] string
  483.           Since release 2.3.0 you can describe, in a special 'table_info'
  484.           table, which field is to be displayed as a tool-tip when moving
  485.           the cursor over the corresponding key.
  486.           This  configuration variable will hold the name of this special
  487.           table. To allow the usage of this functionality:
  488.  
  489.           + set up pmadb and the linked-tables infrastructure
  490.           + put the table name in $cfg['Servers'][$i]['table_info']
  491.           + then for each table where you want to use this feature, click
  492.             "Structure/Relation  view/Choose  field to display" to choose
  493.             the field.
  494.  
  495.           Usage tip: Display field.
  496.  
  497.    $cfg['Servers'][$i]['table_coords'] string
  498.           $cfg['Servers'][$i]['pdf_pages'] string
  499.           Since  release  2.3.0  you can have phpMyAdmin create PDF pages
  500.           showing  the relations between your tables. To do this it needs
  501.           two tables "pdf_pages" (storing information about the available
  502.           PDF  pages)  and "table_coords" (storing coordinates where each
  503.           table will be placed on a PDF schema output).
  504.           You must be using the "relation" feature.
  505.           To allow the usage of this functionality:
  506.  
  507.           + set up pmadb and the linked-tables infrastructure
  508.           + put the correct table names in
  509.             $cfg['Servers'][$i]['table_coords'] and
  510.             $cfg['Servers'][$i]['pdf_pages']
  511.  
  512.           Usage tips: PDF output.
  513.  
  514.    $cfg['Servers'][$i]['column_info'] string
  515.           Since  release  2.3.0  you  can store comments to describe each
  516.           column  for  each  table.  These  will  then  be  shown  on the
  517.           "printview".
  518.           Starting  with release 2.5.0, comments are consequently used on
  519.           the  table  property pages and table browse view, showing up as
  520.           tool-tips  above  the column name (properties page) or embedded
  521.           within  the  header  of  table in browse view. They can also be
  522.           shown  in  a  table dump. Please see the relevant configuration
  523.           directives later on.
  524.           Also new in release 2.5.0 is a MIME-transformation system which
  525.           is   also   based   on   the  following  table  structure.  See
  526.           Transformations   for   further   information.   To   use   the
  527.           MIME-transformation  system, your column_info table has to have
  528.           the    three    new    fields   'mimetype',   'transformation',
  529.           'transformation_options'.
  530.           To allow the usage of this functionality:
  531.  
  532.           + set up pmadb and the linked-tables infrastructure
  533.           + put the table name in $cfg['Servers'][$i]['column_info']
  534.           + to update your PRE-2.5.0 Column_comments Table use this:
  535.                  ALTER TABLE `pma_column_comments`
  536.                    ADD `mimetype` VARCHAR( 255 ) NOT NULL ,
  537.                    ADD `transformation` VARCHAR( 255 ) NOT NULL ,
  538.                    ADD `transformation_options` VARCHAR( 255 ) NOT NULL ;
  539.             and  remember  that  the  Variable in config.inc.php has been
  540.             renamed from
  541.             $cfg['Servers'][$i]['column_comments']                     to
  542.             $cfg['Servers'][$i]['column_info']
  543.  
  544.    $cfg['Servers'][$i]['history'] string
  545.           Since release 2.5.0 you can store your SQL history, which means
  546.           all queries you entered manually into the phpMyAdmin interface.
  547.           If  you  don't  want to use a table- based history, you can use
  548.           the  JavaScript-based  history.  Using  that,  all your history
  549.           items are deleted when closing the window.
  550.           Using  $cfg['QueryHistoryMax']  you  can  specify  an amount of
  551.           history  items  you  want to have on hold. On every login, this
  552.           list gets cut to the maximum amount.
  553.           The   query   history   is   only  available  if  you  use  the
  554.           JavaScript-based query window, see $cfg['QueryFrame'].
  555.           To allow the usage of this functionality:
  556.  
  557.           + set up pmadb and the linked-tables infrastructure
  558.           + put the table name in $cfg['Servers'][$i]['history']
  559.  
  560.    $cfg['Servers'][$i]['verbose_check'] string
  561.           Because  release  2.5.0  introduced the new MIME-transformation
  562.           support,  the  column_info  table  got  enhanced with three new
  563.           fields.  If  the  above  variable  is  set  to  TRUE  (default)
  564.           phpMyAdmin  will  check  if you have the latest table structure
  565.           available. If not, it will emit a warning to the superuser.
  566.           You  can disable this checking behavior by setting the variable
  567.           to false, which should offer a performance increase.
  568.           Recommended  to  set  to  FALSE,  when you are sure, your table
  569.           structure is up to date.
  570.  
  571.    $cfg['Servers'][$i]['AllowDeny']['order'] string
  572.           If  your  rule  order  is  empty,  then  IP  authentication  is
  573.           disabled.
  574.           If  your  rule  order  is  set  to 'deny,allow' then the system
  575.           applies  all  deny  rules  followed  by  allow rules. Access is
  576.           allowed  by  default.  Any  client  which does not match a Deny
  577.           command  or  does match an Allow command will be allowed access
  578.           to the server.
  579.           If  your  rule  order  is  set  to 'allow,deny' then the system
  580.           applies  all  allow  rules  followed  by  deny rules. Access is
  581.           denied  by  default.  Any  client which does not match an Allow
  582.           directive  or does match a Deny directive will be denied access
  583.           to the server.
  584.           If  your rule order is set to 'explicit', the authentication is
  585.           performed in a similar fashion to rule order 'deny,allow', with
  586.           the  added restriction that your host/username combination must
  587.           be listed in the allow rules, and not listed in the deny rules.
  588.           This  is  the  most secure means of using Allow/Deny rules, and
  589.           was  available  in  Apache  by  specifying allow and deny rules
  590.           without setting any order.
  591.  
  592.    $cfg['Servers'][$i]['AllowDeny']['rules'] array of strings
  593.           The general format for the rules is as such:
  594.                 <'allow' | 'deny'> <username> [from] <ipmask>
  595.           If  you wish to match all users, it is possible to use a '%' as
  596.           a wildcard in the username field.
  597.           There  are  a  few shortcuts you can use in the ipmask field as
  598.           well:
  599.                'all' -> 0.0.0.0/0
  600.                'localhost' -> 127.0.0.1/8
  601.           Having  an empty rule list is equivalent to either using 'allow
  602.           %  from all' if your rule order is set to 'deny,allow' or 'deny
  603.           %  from  all'  if  your  rule  order  is set to 'allow,deny' or
  604.           'explicit'.
  605.           For the IP matching system, the following work:
  606.           xxx.xxx.xxx.xxx (an exact IP address)
  607.           xxx.xxx.xxx.[yyy-zzz] (an IP address range)
  608.           xxx.xxx.xxx.xxx/nn  (CIDR,  Classless Inter-Domain Routing type
  609.           IP addresses)
  610.           But the following does not work:
  611.           xxx.xxx.xxx.xx[yyy-zzz] (partial IP address range)
  612.  
  613.    $cfg['ServerDefault'] integer
  614.           If  you  have  more  than  one  server  configured, you can set
  615.           $cfg['ServerDefault'] to any one of them to autoconnect to that
  616.           server when phpMyAdmin is started, or set it to 0 to be given a
  617.           list of servers without logging in.
  618.           If  you  have only one server configured, $cfg['ServerDefault']
  619.           MUST be set to that server.
  620.  
  621.    $cfg['OBGzip'] string/boolean
  622.           Defines  whether  to  use  GZip  output buffering for increased
  623.           speed in HTTP transfers.
  624.           Set  to  true/false  for enabling/disabling. When set to 'auto'
  625.           (string),  phpMyAdmin tries to enable output buffering and will
  626.           automatically  disable  it,  if  your browser has some problems
  627.           with buffering. IE6 with a certain patch is known to cause data
  628.           corruption having enabled buffering.
  629.  
  630.    $cfg['PersistentConnections'] boolean
  631.           Whether   persistent   connections   should   be  used  or  not
  632.           (mysql_connect or mysql_pconnect).
  633.  
  634.    $cfg['ExecTimeLimit'] integer [number of seconds]
  635.           Set  the  number  of  seconds  a  script  is allowed to run. If
  636.           seconds is set to zero, no time limit is imposed.
  637.           This  setting  is used while importing/exporting dump files but
  638.           has no effect when PHP is running in safe mode.
  639.  
  640.    $cfg['SkipLockedTables'] boolean
  641.           Mark  used  tables  and make it possible to show databases with
  642.           locked tables (since 3.23.30).
  643.  
  644.    $cfg['ShowSQL'] boolean
  645.           Defines  whether  SQL-queries generated by phpMyAdmin should be
  646.           displayed or not.
  647.  
  648.    $cfg['AllowUserDropDatabase'] boolean
  649.           Defines whether normal users (non-administrator) are allowed to
  650.           delete  their  own  database  or not. If set as FALSE, the link
  651.           "Drop  Database"  will  not be shown, and even a "DROP DATABASE
  652.           mydatabase"  will  be  rejected. Quite practical for ISP's with
  653.           many customers.
  654.  
  655.    $cfg['Confirm'] boolean
  656.           Whether  a  warning  ("Are  your  really  sure...")  should  be
  657.           displayed when you're about to lose data.
  658.  
  659.    $cfg['LoginCookieRecall'] boolean
  660.           Define  whether the previous login should be recalled or not in
  661.           cookie authentication mode.
  662.  
  663.    $cfg['UseDbSearch'] boolean
  664.           Define  whether  the "search string inside database" is enabled
  665.           or not.
  666.  
  667.    $cfg['IgnoreMultiSubmitErrors'] boolean
  668.           Define whether phpMyAdmin will continue executing a multi-query
  669.           statement  if  one  of  the  queries fails. Default is to abort
  670.           execution.
  671.  
  672.    $cfg['VerboseMultiSubmit'] boolean
  673.           Define whether phpMyAdmin will output the results of each query
  674.           of  a  multi-query  statement  embedded  into the SQL output as
  675.           inline comments. Defaults to TRUE.
  676.  
  677.    $cfg['AllowArbitraryServer'] boolean
  678.           If enabled allows you to login to arbitrary server using cookie
  679.           auth.
  680.           NOTE:  Please  use  this carefully, as this may allow to access
  681.           MySQL servers behind firewall where your http server is placed.
  682.  
  683.    $cfg['LeftFrameLight'] boolean
  684.           Defines  whether  to use select-based menu and display only the
  685.           current  tables  in  the  left  frame  (smaller  page). Only in
  686.           Non-Lightmode you can use the feature to display nested folders
  687.           using $cfg['LeftFrameTableSeparator']
  688.  
  689.    $cfg['LeftFrameTableSeparator'] string
  690.           Defines  a  string to be used to nest table spaces. Defaults to
  691.           '__'. This means if you have tables like 'first__second__third'
  692.           this  will  be  shown as a three-level hierarchie like: first >
  693.           second  >  third.  If  set  to  FALSE  or empty, the feature is
  694.           disabled.  NOTE:  You  shall  not use this Separator in a table
  695.           name at the beginning or end of a table name, or multiple times
  696.           after another without any other characters in between.
  697.  
  698.    $cfg['LeftFrameTableLevel'] string
  699.           Defines  how  many sublevels should be displayed when splitting
  700.           up tables by the above Separator.
  701.  
  702.    $cfg['ShowTooltip'] boolean
  703.           Defines  whether  to  display table comment as tool-tip in left
  704.           frame or not.
  705.  
  706.    $cfg['ShowTooltipAliasDB'] boolean
  707.           If  tool-tips  are  enabled  and a DB comment is set, this will
  708.           flip  the  comment and the real name. That means, if you have a
  709.           table called 'user0001' and add the comment 'MyName' on it, you
  710.           will  see the name 'MyName' used consequently in the left frame
  711.           and the tool-tip shows the real name of the DB.
  712.  
  713.    $cfg['ShowTooltipAliasTB'] boolean/string
  714.           Same as $cfg['ShowTooltipAliasDB'], except this works for table
  715.           names.  When  setting  this  to  'nested',  the  Alias  of  the
  716.           Tablename  is  only  used to split/nest the tables according to
  717.           the  $cfg['LeftFrameTableSeparator']  directive.  So  only  the
  718.           folder is called like the Alias, the tablename itself stays the
  719.           real tablename.
  720.  
  721.    $cfg['LeftDisplayLogo'] boolean
  722.           Defines  whether  to  display the phpMyAdmin logo at the top of
  723.           the left frame or not. Defaults to TRUE.
  724.  
  725.    $cfg['LeftDisplayServers'] boolean
  726.           Defines  whether  to  display a server choice at the top of the
  727.           left frame or not. Defaults to FALSE.
  728.  
  729.    $cfg['DisplayServersList'] boolean
  730.           Defines  whether to display this server choice as links instead
  731.           of in a drop-down. Defaults to FALSE (drop-down).
  732.  
  733.    $cfg['ShowStats'] boolean
  734.           Defines  whether  to  display  space usage and statistics about
  735.           databases and tables or not.
  736.           Note  that  statistics requires at least MySQL 3.23.3 and that,
  737.           at  this  date,  MySQL  doesn't  return  such  information  for
  738.           Berkeley DB tables.
  739.  
  740.    $cfg['ShowMysqlInfo'] boolean
  741.           $cfg['ShowMysqlVars'] boolean
  742.           $cfg['ShowPhpInfo'] boolean
  743.           $cfg['ShowChgPassword'] boolean
  744.           Defines  whether  to  display  the "MySQL runtime information",
  745.           "MySQL   system   variables",  "PHP  information"  and  "Change
  746.           password  "  links or not for simple users at the starting main
  747.           (right)  frame.  This  setting  does  not  check MySQL commands
  748.           entered directly.
  749.           Please  note  that  to block the usage of phpinfo() in scripts,
  750.           you have to put this in your php.ini:
  751.               disable_functions = phpinfo()
  752.           Also  note  that  enabling  the  "Change password " link has no
  753.           effect  with  "config" authentication mode: because of the hard
  754.           coded password value in the configuration file, end users can't
  755.           be allowed to change their passwords.
  756.  
  757.    $cfg['SuggestDBName'] boolean
  758.           Defines  whether  to  suggest  a  database  name on the "Create
  759.           Database" form or to keep the textfield empty.
  760.  
  761.    $cfg['ShowBlob'] boolean
  762.           Defines  whether  BLOB fields are shown when browsing a table's
  763.           content or not.
  764.  
  765.    $cfg['NavigationBarIconic'] boolean
  766.           Defines  whether navigation bar buttons contain text or symbols
  767.           only.
  768.  
  769.    $cfg['ShowAll'] boolean
  770.           Defines  whether  an  user  should  be  displayed  a  "show all
  771.           (records)" button in browse mode or not.
  772.  
  773.    $cfg['MaxRows'] integer
  774.           Number  of  rows  displayed  when browsing a result set. If the
  775.           result  set  contains  more  rows,  Previous/Next links will be
  776.           shown.
  777.  
  778.    $cfg['Order'] string [DESC|ASC|SMART]
  779.           Defines  whether fields are displayed in ascending (ASC) order,
  780.           in descending (DESC) order or in a "smart" (SMART) order - I.E.
  781.           descending  order  for  fields  of  type TIME, DATE, DATETIME &
  782.           TIMESTAMP, ascending order else- by default.
  783.  
  784.    $cfg['ProtectBinary'] boolean or string
  785.           Defines  whether  BLOB  or  BINARY  fields  are  protected from
  786.           edition  when  browsing  a table's content or not. Valid values
  787.           are:
  788.           - FALSE to allow edition of all fields;
  789.           - blob to allow edition of all fields except BLOBS;
  790.           - all to disallow edition of all BINARY or BLOB fields.
  791.  
  792.    $cfg['ShowFunctionFields'] boolean
  793.           Defines  whether  MySQL functions fields should be displayed or
  794.           not in edit/insert mode.
  795.  
  796.    $cfg['CharEditing'] string
  797.           Defines  which type of editing controls should be used for CHAR
  798.           and VARCHAR fields. Possible values are:
  799.  
  800.           + input - this allows to limit size of text to size of field in
  801.             MySQL, but has problems with newlines in fields
  802.           + textarea  -  no problems with newlines in fields, but also no
  803.             length limitations
  804.  
  805.           Default is old behavior so input.
  806.  
  807.    $cfg['ZipDump'] boolean
  808.           $cfg['GZipDump'] boolean
  809.           $cfg['BZipDump'] boolean
  810.           Defines  whether to allow the use of zip/GZip/BZip2 compression
  811.           when creating a dump file or not.
  812.  
  813.    $cfg['CompressOnFly'] boolean
  814.           Defines  whether to allow on the fly compression for GZip/BZip2
  815.           compressed  exports.  This  doesn't  affect  smaller  dumps and
  816.           allows  to  create  larger  dumps,  that won't fit otherwise in
  817.           memory  due  to  php  memory limit. Produced files contain more
  818.           GZip/BZip2   headers,  but  all  normal  programs  handle  this
  819.           correctly.
  820.  
  821.    $cfg['LightTabs'] string
  822.           If set to True, do use less graphically intense tabs on the top
  823.           of the mainframe.
  824.  
  825.    $cfg['PropertiesIconic'] string
  826.           If  set  to True, will display icons instead of text for db and
  827.           table  properties  links  (like  'Browse',  'Select', 'Insert',
  828.           ...).
  829.           Can be set to 'both' if you want icons AND text.
  830.           When set to False, will only show text.
  831.  
  832.    $cfg['PropertiesNumColumns'] integer
  833.           How  many columns will be utilized to display the tables on the
  834.           database  property view? Default is 1 column. When setting this
  835.           to  a  value  larger  than  1, the type of the database will be
  836.           omitted for more display space.
  837.  
  838.    $cfg['DefaultTabServer'] string
  839.           Defines  the  tab displayed by default on server view. Possible
  840.           values:   "main.php"   (recommended   for  multi-user  setups),
  841.           "server_databases.php",                    "server_status.php",
  842.           "server_variables.php",        "server_privileges.php"       or
  843.           "server_processlist.php".
  844.  
  845.    $cfg['DefaultTabDatabase'] string
  846.           Defines the tab displayed by default on database view. Possible
  847.           values:    "db_details_structure.php",    "db_details.php"   or
  848.           "db_search.php".
  849.  
  850.    $cfg['DefaultTabTable'] string
  851.           Defines  the  tab  displayed by default on table view. Possible
  852.           values:  "tbl_properties_structure.php",  "tbl_properties.php",
  853.           "tbl_select.php" or "tbl_change.php".
  854.  
  855.    $cfg['MySQLManualBase'] string
  856.           If  set to an URL which points to the MySQL documentation (type
  857.           depends on $cfg['MySQLManualType']), appropriate help links are
  858.           generated.
  859.           See  MySQL  Documentation page for more information about MySQL
  860.           manuals and their types.
  861.  
  862.    $cfg['MySQLManualType'] string
  863.           Type of MySQL documentation:
  864.  
  865.           + old - old style used in phpMyAdmin 2.3.0 and earlier
  866.           + searchable - "Searchable, with user comments"
  867.           + chapters - "HTML, one page per chapter"
  868.           + big - "HTML, all on one page"
  869.           + none - do not show documentation links
  870.  
  871.    $cfg['DefaultLang'] string
  872.           Defines  the default language to use, if not browser-defined or
  873.           user-defined.
  874.           See the select_lang.inc.php script to know the valid values for
  875.           this setting.
  876.  
  877.    $cfg['Lang'] string
  878.           Force:  always  use  this  language  (must  be  defined  in the
  879.           select_lang.inc.php script).
  880.  
  881.    $cfg['DefaultCharset'] string
  882.           Default  character  set  to  use for recoding of MySQL queries.
  883.           This    must    be    enabled    and    it's    described    by
  884.           $cfg['AllowAnywhereRecoding'] option.
  885.           You   can   give   here   any   character   set   which  is  in
  886.           $cfg['AvailableCharsets']   array  and  this  is  just  default
  887.           choice, user can select any of them.
  888.  
  889.    $cfg['AllowAnywhereRecoding'] boolean
  890.           Allow  character set recoding of MySQL queries. You need recode
  891.           or  iconv support (compiled in or module) in PHP to allow MySQL
  892.           queries  recoding  and  used language file must have it enabled
  893.           (by  default  only  these  which  are in Unicode, just to avoid
  894.           losing some characters).
  895.  
  896.    $cfg['RecodingEngine'] string
  897.           You  can select here which functions will be used for character
  898.           set conversion. Possible values are:
  899.  
  900.           + auto  -  automatically  use  available  one  (first is tested
  901.             iconv, then recode)
  902.           + iconv - use iconv or libiconv functions
  903.           + recode - use recode_string function
  904.  
  905.           Default is auto.
  906.  
  907.    $cfg['IconvExtraParams'] string
  908.           Specify  some  parameters for iconv used in charset conversion.
  909.           See iconv documentation for details.
  910.  
  911.    $cfg['AvailableCharsets'] array
  912.           Available character sets for MySQL conversion. You can add your
  913.           own  (any  of  supported by recode/iconv) or remove these which
  914.           you  don't  use.  Character sets will be shown in same order as
  915.           here  listed,  so if you frequently use some of these move them
  916.           to the top.
  917.  
  918.    $cfg['GD2Available'] string
  919.           Specifies  whether  GD >= 2 is available. If yes it can be used
  920.           for MIME transformations.
  921.           Possible values are:
  922.  
  923.           + auto   -  automatically  detect,  this  is  a  bit  expensive
  924.             operation  for  php < 4.3.0 so it is preferred to change this
  925.             according to your server real possibilities
  926.           + yes - GD 2 functions can be used
  927.           + no - GD 2 function cannot be used
  928.  
  929.           Default is auto.
  930.  
  931.    $cfg['LeftWidth'] integer
  932.           Left frame width in pixel. See themes/themename/layout.inc.php.
  933.  
  934.    $cfg['LeftBgColor'] string [HTML color]
  935.           $cfg['RightBgColor'] string [HTML color]
  936.           The  background  colors  (HTML)  used  for both the frames. See
  937.           themes/themename/layout.inc.php.
  938.  
  939.    $cfg['RightBgImage'] string
  940.           The  URI  of  the background image used for the right frame. It
  941.           must be an absolute URI. See themes/themename/layout.inc.php.
  942.  
  943.    $cfg['LeftPointerColor'] string [HTML color]
  944.           The  color  (HTML) used for the pointer in the left frame (does
  945.           not work with Netscape 4). See themes/themename/layout.inc.php.
  946.  
  947.    $cfg['LeftPointerEnable'] boolean
  948.           A value of TRUE activates the left pointer (when LeftFrameLight
  949.           is FALSE).
  950.  
  951.    $cfg['Border'] integer
  952.           The size of a table's border. See
  953.           themes/themename/layout.inc.php.
  954.  
  955.    $cfg['ThBgcolor'] string [HTML color]
  956.           The    color    (HTML)    used    for    table   headers.   See
  957.           themes/themename/layout.inc.php.
  958.  
  959.    $cfg['BgcolorOne'] string [HTML color]
  960.           The color (HTML) #1 for table rows. See
  961.           themes/themename/layout.inc.php.
  962.  
  963.    $cfg['BgcolorTwo'] string [HTML color]
  964.           The color (HTML) #2 for table rows. See
  965.           themes/themename/layout.inc.php.
  966.  
  967.    $cfg['BrowsePointerColor'] string [HTML color]
  968.           $cfg['BrowseMarkerColor'] string [HTML color]
  969.           The colors (HTML) uses for the pointer and the marker in browse
  970.           mode (does not work with Netscape 4).
  971.           The  former feature highlights the row over which your mouse is
  972.           passing  and  the  latter lets you visually mark/unmark rows by
  973.           clicking on them.
  974.           See themes/themename/layout.inc.php.
  975.  
  976.    $cfg['BrowsePointerEnable'] boolean
  977.           Whether to activate the browse pointer or not.
  978.  
  979.    $cfg['BrowseMarkerEnable'] boolean
  980.           Whether to activate the browse marker or not.
  981.  
  982.    $cfg['TextareaCols'] integer
  983.           $cfg['TextareaRows'] integer
  984.           $cfg['CharTextareaCols'] integer
  985.           $cfg['CharTextareaRows'] integer
  986.           Number of columns and rows for the textareas.
  987.           This  value will be emphasized (*2) for SQL query textareas and
  988.           (*1.25) for SQL textareas inside the query window.
  989.           The  Char*  values  are  used  for CHAR and VARCHAR editing (if
  990.           configured via $cfg['CharEditing']).
  991.  
  992.    $cfg['LongtextDoubleTextarea'] boolean
  993.           Defines whether textarea for LONGTEXT fields should have double
  994.           size.
  995.  
  996.    $cfg['TextareaAutoSelect'] boolean
  997.           Defines if the whole textarea of the query box will be selected
  998.           on click.
  999.  
  1000.    $cfg['CtrlArrowsMoving'] boolean
  1001.           Enable Ctrl+Arrows moving between fields when editing?
  1002.  
  1003.    $cfg['LimitChars'] integer
  1004.           Maximal  number  of  Chars  showed  in any non-numeric field on
  1005.           browse view. Can be turned off by a toggle button on the browse
  1006.           page.
  1007.  
  1008.    $cfg['ModifyDeleteAtLeft'] boolean
  1009.           $cfg['ModifyDeleteAtRight'] boolean
  1010.           Defines  the  place  where modify and delete links would be put
  1011.           when tables contents are displayed (you may have them displayed
  1012.           both  at  the  left  and  at the right). "Left" and "right" are
  1013.           parsed as "top" and "bottom" with vertical display mode.
  1014.  
  1015.    $cfg['DefaultDisplay'] string
  1016.           $cfg['HeaderFlipType'] string
  1017.           There  are  3  display modes: horizontal, horizontalflipped and
  1018.           vertical.  Define  which one is displayed by default. The first
  1019.           mode displays each row on a horizontal line, the second rotates
  1020.           the  headers  by 90 degrees, so you can use descriptive headers
  1021.           even  though  fields  only contain small values and still print
  1022.           them  out.  The  vertical  mode  sorts  each  row on a vertical
  1023.           lineup.
  1024.           The  HeaderFlipType  can be set to 'css' or 'faked'. When using
  1025.           'css'  the rotation of the header for horizontalflipped is done
  1026.           via CSS. If set to 'faked' PHP does the transformation for you,
  1027.           but of course this does not look as good as CSS.
  1028.  
  1029.    $cfg['DefaultPropDisplay'] string
  1030.           When  editing/creating  new  columns  in  a  table  all  fields
  1031.           normally   get   lined   up   one   field   a  line.  (default:
  1032.           'horizontal').  If you set this to 'vertical' you can have each
  1033.           field lined up vertically beneath each other. You can save up a
  1034.           lot  of place on the horizontal direction and no longer have to
  1035.           scroll.
  1036.  
  1037.    $cfg['ShowBrowseComments'] boolean
  1038.           $cfg['ShowPropertyComments'] boolean
  1039.           By  setting  the  corresponding variable to TRUE you can enable
  1040.           the  display  of column comments in Browse or Property display.
  1041.           In  browse  mode,  the  comments are show inside the header. In
  1042.           property  mode,  comments  are  displayed using a CSS-formatted
  1043.           dashed-line  below  the name of the field. The comment is shown
  1044.           as a tool-tip for that field.
  1045.  
  1046.    $cfg['UploadDir'] string
  1047.           The  name  of the directory, where SQL files have been uploaded
  1048.           by  other means than phpMyAdmin (for example, ftp). Those files
  1049.           are available under a drop-down box when you click the database
  1050.           name, then the SQL tab.
  1051.           Please note that the file names must have the suffix ".sql" (or
  1052.           ".sql.bz2"  or  ".sql.gz"  if support for compressed formats is
  1053.           enabled).
  1054.           This feature is useful when your file is too big to be uploaded
  1055.           via HTTP, or when file uploads are disabled in PHP.
  1056.           Please note that if PHP is running in safe mode, this directory
  1057.           must  be  owned by the same user as the owner of the phpMyAdmin
  1058.           scripts.
  1059.  
  1060.    $cfg['docSQLDir'] string
  1061.           The  name  of the directory, where docSQL files can be uploaded
  1062.           for import into phpMyAdmin.
  1063.           Please note that if PHP is running in safe mode, this directory
  1064.           must  be  owned by the same user as the owner of the phpMyAdmin
  1065.           scripts.
  1066.  
  1067.    $cfg['SaveDir'] string
  1068.           The name of the directory, where dumps can be saved.
  1069.           Please  note  that  the  directory  has to be writable for user
  1070.           running webserver.
  1071.           Please note that if PHP is running in safe mode, this directory
  1072.           must  be  owned by the same user as the owner of the phpMyAdmin
  1073.           scripts.
  1074.  
  1075.    $cfg['TempDir'] string
  1076.           The name of the directory, where temporary files can be stored.
  1077.           This is needed for native MS Excel export, see FAQ 6.23
  1078.  
  1079.    $cfg['Export'] array
  1080.           In  this array are defined default parameters for export, names
  1081.           of  items  are similar to texts seen on export page, so you can
  1082.           easily identify what they mean.
  1083.  
  1084.    $cfg['RepeatCells'] integer
  1085.           Repeat the headers every X cells, or 0 to deactivate.
  1086.  
  1087.    $cfg['QueryFrame'] boolean
  1088.           $cfg['QueryFrameJS'] boolean
  1089.           $cfg['QueryWindowWidth'] integer
  1090.           $cfg['QueryWindowHeight'] integer
  1091.           $cfg['QueryHistoryDB'] boolean
  1092.           $cfg['QueryWindowDefTab'] string
  1093.           $cfg['QueryHistoryMax'] integer
  1094.           All   those  variables  affect  the  query  box  feature.  When
  1095.           $cfg['QueryFrame']  is set to true, a link or icon is displayed
  1096.           on the left panel. Clicking on it opens the query box, a direct
  1097.           interface to enter SQL queries.
  1098.           When $cfg['QueryFrameJS'] is set to true, clicking on that link
  1099.           opens  the  query  box,  a  new  custom  sized  browser  window
  1100.           ($cfg['QueryWindowWidth'],   $cfg['QueryWindowWidth']   -  both
  1101.           integers  for the size in pixels). Also, a click on [Edit] from
  1102.           the  results  page  (in  the  "Showing Rows" section) opens the
  1103.           query  box  and  puts  the  current  query inside it. If set to
  1104.           false,  clicking  on  the  link only opens the SQL input in the
  1105.           main frame.
  1106.           The  usage of the JavaScript query window is recommended if you
  1107.           have  a JavaScript enabled browser. Basic functions are used to
  1108.           exchange quite a few variables, so most 4th generation browsers
  1109.           should  be  capable  to  use that feature. It currently is only
  1110.           tested with Internet Explorer 6 and Mozilla 1.x.
  1111.           If  $cfg['QueryHistoryDB'] is set to TRUE, all your Queries are
  1112.           logged  to  a  table,  which  has  to  be  created  by you (see
  1113.           $cfg['Servers'][$i]['history']).  If  set  to  FALSE,  all your
  1114.           queries  will be appended to the form, but only as long as your
  1115.           window is opened they remain saved.
  1116.           When  using  the  JavaScript based query window, it will always
  1117.           get updated when you click on a new table/db to browse and will
  1118.           focus  if  you click on "Edit SQL" after using a query. You can
  1119.           suppress  updating the query window by checking the box "Do not
  1120.           overwrite  this  query from outside the window" below the query
  1121.           textarea.   Then   you   can  browse  tables/databases  in  the
  1122.           background without losing the contents of the textarea, so this
  1123.           is  especially  useful  when  composing a query with tables you
  1124.           first  have  to  look  in.  The checkbox will get automatically
  1125.           checked  whenever  you  change  the  contents  of the textarea.
  1126.           Please  uncheck  the  button  whenever  you definitely want the
  1127.           query   window  to  get  updated  even  though  you  have  made
  1128.           alterations.
  1129.           If  $cfg['QueryHistoryDB']  is  set to TRUE you can specify the
  1130.           amount of saved history items using $cfg['QueryHistoryMax'].
  1131.           The  query  window  also  has a custom tabbed look to group the
  1132.           features.  Using the variable $cfg['QueryWindowDefTab'] you can
  1133.           specify  the  default  tab  to  be  used when opening the query
  1134.           window.  It  can  be set to either 'sql', 'files', 'history' or
  1135.           'full'.
  1136.  
  1137.    $cfg['BrowseMIME'] boolean
  1138.           Enable MIME-transformations.
  1139.  
  1140.    $cfg['MaxExactCount'] integer
  1141.           Determines for how large tables phpMyAdmin should get exact row
  1142.           count by SELECT COUNT. If approximate row count is smaller than
  1143.           this  value,  SELECT  COUNT  will be used, otherwise only value
  1144.           returned by SHOW TABLE STATUS.
  1145.  
  1146.    $cfg['WYSIWYG-PDF'] boolean
  1147.           Utilizes  a WYSIWYG editing control to easily place elements of
  1148.           a  PDF page. By clicking on the button 'toggle scratchboard' on
  1149.           the  page  where you edit x/y coordinates of those elements you
  1150.           can activate a scratchboard where all your elements are placed.
  1151.           By  clicking  on  an  element,  you can move them around in the
  1152.           pre-defined  area  and  the  x/y  coordinates  will get updated
  1153.           dynamically.  Likewise,  when  entering a new position directly
  1154.           into  the  input  field,  the  new position in the scratchboard
  1155.           changes after your cursor leaves the input field.
  1156.           You  have  to click on the 'OK'-button below the tables to save
  1157.           the  new  positions.  If you want to place a new element, first
  1158.           add  it  to the table of elements and then you can drag the new
  1159.           element around.
  1160.           By  changing  the paper size and the orientation you can change
  1161.           the  size  of  the  scratchboard as well. You can do so by just
  1162.           changing  the  dropdown  field below, and the scratchboard will
  1163.           resize  automatically,  without  interfering  with  the current
  1164.           placement of the elements.
  1165.           If ever an element gets out of range you can either enlarge the
  1166.           paper size or click on the 'reset' button to place all elements
  1167.           below each other.
  1168.           NOTE:  You  have to use a recent browser like IE6 or Mozilla to
  1169.           get   this   control   to  work.  The  basic  Drag&Drop  script
  1170.           functionality  was kindly borrowed from www.youngpup.net and is
  1171.           underlying so specific license.
  1172.  
  1173.    $cfg['NaturalOrder'] boolean
  1174.           Sorts  database and table names according to natural order (for
  1175.           example,  t1, t2, t10). Currently implemented in the left panel
  1176.           (Light mode) and in Database view, for the table list.
  1177.  
  1178.    $cfg['ShowHttpHostTitle'] boolean
  1179.           Shows the HTTP host name in window's title bar.
  1180.  
  1181.    $cfg['SetHttpHostTitle'] string
  1182.           If  $cfg['ShowHttpHostTitle']  is  TRUE, it shows the real HTTP
  1183.           host name, unless an alternate name is set here.
  1184.  
  1185.    $cfg['ErrorIconic'] boolean
  1186.           Uses icons for warnings, errors and informations.
  1187.  
  1188.    $cfg['MainPageIconic'] boolean
  1189.           Uses  icons  on main page in lists, on right panel top menu and
  1190.           menu tabs.
  1191.  
  1192.    $cfg['ReplaceHelpImg'] boolean
  1193.           Shows a help button instead of the "Documentation" message.
  1194.  
  1195.    $cfg['ThemePath'] string
  1196.           If  theme  manager  is  active,  use  this  as  the path of the
  1197.           subdirectory containing all the themes.
  1198.  
  1199.    $cfg['ThemeManager'] boolean
  1200.           Enables user-selectable themes. See FAQ 2.7.
  1201.  
  1202.    $cfg['ThemeDefault'] string
  1203.           The default theme (a subdirectory under cfg['ThemePath']).
  1204.  
  1205.    $cfg['DefaultQueryTable'] string
  1206.    $cfg['DefaultQueryDatabase'] string
  1207.           Default queries that will be displayed in query boxes when user
  1208.           didn't specify any. Use %d for database name, %t for table name
  1209.           and  %f for a comma separated list of field names. Note that %t
  1210.           and %f are only applicable to $cfg['DefaultQueryTable'].
  1211.  
  1212.    $cfg['SQP']['fmtType'] string [html|none]
  1213.           The  main  use  of  the  new  SQL Parser is to pretty-print SQL
  1214.           queries.  By  default  we use HTML to format the query, but you
  1215.           can disable this by setting this variable to 'none'.
  1216.  
  1217.    $cfg['SQP']['fmtInd'] float
  1218.           $cfg['SQP']['fmtIndUnit'] string [em|px|pt|ex]
  1219.           For  the  pretty-printing  of SQL queries, under some cases the
  1220.           part  of  a  query  inside  a  bracket is indented. By changing
  1221.           $cfg['SQP']['fmtInd'] you can change the amount of this indent.
  1222.           Related in purpose is $cfg['SQP']['fmtIndUnit'] which specifies
  1223.           the units of the indent amount that you specified. This is used
  1224.           via stylesheets.
  1225.  
  1226.    $cfg['SQP']['fmtColor'] array of string tuples
  1227.           This  array  is  used  to  define  the colours for each type of
  1228.           element of the pretty-printed SQL queries. The tuple format is
  1229.           class => [HTML colour code | empty string]
  1230.           If  you specify an empty string for the color of a class, it is
  1231.           ignored  in  creating  the stylesheet. You should not alter the
  1232.           class names, only the colour strings.
  1233.           Class name key:
  1234.  
  1235.           + comment Applies to all comment sub-classes
  1236.           + comment_mysql Comments as "#...\n"
  1237.           + comment_ansi Comments as "-- ...\n"
  1238.           + comment_c Comments as "/*...*/"
  1239.           + digit Applies to all digit sub-classes
  1240.           + digit_hex Hexadecimal numbers
  1241.           + digit_integer Integer numbers
  1242.           + digit_float Floating point numbers
  1243.           + punct Applies to all punctuation sub-classes
  1244.           + punct_bracket_open_round Opening brackets"("
  1245.           + punct_bracket_close_round Closing brackets ")"
  1246.           + punct_listsep List item Separator ","
  1247.           + punct_qualifier Table/Column Qualifier "."
  1248.           + punct_queryend End of query marker ";"
  1249.           + alpha Applies to all alphabetic classes
  1250.           + alpha_columnType Identifiers matching a column type
  1251.           + alpha_columnAttrib        Identifiers        matching       a
  1252.             database/table/column attribute
  1253.           + alpha_functionName Identifiers matching a MySQL function name
  1254.           + alpha_reservedWord  Identifiers  matching  any other reserved
  1255.             word
  1256.           + alpha_variable Identifiers matching a SQL variable "@foo"
  1257.           + alpha_identifier All other identifiers
  1258.           + quote Applies to all quotation mark classes
  1259.           + quote_double Double quotes "
  1260.           + quote_single Single quotes '
  1261.           + quote_backtick Backtick quotes `
  1262.  
  1263.    $cfg['SQLValidator']['use'] boolean
  1264.           phpMyAdmin now supports use of the Mimer SQL Validator service,
  1265.           as originally published on Slashdot.
  1266.           For  help in setting up your system to use the service, see the
  1267.           FAQ #6.14.
  1268.  
  1269.    $cfg['SQLValidator']['username'] string
  1270.           $cfg['SQLValidator']['password'] string
  1271.           The  SOAP  service  allows  you to login with anonymous and any
  1272.           password,  so  we use those by default. Instead, if you have an
  1273.           account  with them, you can put your login details here, and it
  1274.           will be used in place of the anonymous login.
  1275.  
  1276.    $cfg['DBG']['enable'] boolean
  1277.           DEVELOPERS ONLY!
  1278.           Enable the DBG extension for debugging phpMyAdmin. Required for
  1279.           profiling the code.
  1280.           For  help in setting up your system to this, see the Developers
  1281.           section.
  1282.  
  1283.    $cfg['DBG']['profile']['enable'] boolean
  1284.           DEVELOPERS ONLY!
  1285.           Enable  profiling  support  for  phpMyAdmin. This will append a
  1286.           chunk  of  data  to the end of every page displayed in the main
  1287.           window with profiling statistics for that page.
  1288.           You may need to increase the maximum execution time for this to
  1289.           complete successfully.
  1290.  
  1291.    $cfg['DBG']['profile']['threshold'] float (units in milliseconds)
  1292.           DEVELOPERS ONLY!
  1293.           When  profiling  data  is displayed, this variable controls the
  1294.           threshold  of  display  for  any  profiling  data, based on the
  1295.           average  time  each time has taken. If it is over the threshold
  1296.           it  is  displayed,  otherwise it is not displayed. This takes a
  1297.           value  in  milliseconds.  In  most cases you don't need to edit
  1298.           this.
  1299.  
  1300.    $cfg['ColumnTypes'] array
  1301.           All  possible  types of a MySQL column. In most cases you don't
  1302.           need to edit this.
  1303.  
  1304.    $cfg['AttributeTypes'] array
  1305.           Possible attributes for fields. In most cases you don't need to
  1306.           edit this.
  1307.  
  1308.    $cfg['Functions'] array
  1309.           A  list  of  functions  MySQL supports. In most cases you don't
  1310.           need to edit this.
  1311.  
  1312.    $cfg['RestrictColumnTypes'] array
  1313.           Mapping  of  column  types  to  meta  types used for preferring
  1314.           displayed functions. In most cases you don't need to edit this.
  1315.  
  1316.    $cfg['RestrictFunctions'] array
  1317.           Functions  preferred  for  column  meta  types  as  defined  in
  1318.           $cfg['RestrictColumnTypes'].  In  most  cases you don't need to
  1319.           edit this.
  1320.  
  1321.    $cfg['DefaultFunctions'] array
  1322.           Functions  selected  by  default  when  insering/changing  row,
  1323.           Functions     are     defined     for     meta    types    from
  1324.           $cfg['RestrictColumnTypes']  and  for first_timestamp, which is
  1325.           used for first timestamp column in table.
  1326.  
  1327.    $cfg['NumOperators'] array
  1328.           Operators  available  for search operations on numeric and date
  1329.           fields.
  1330.  
  1331.    $cfg['TextOperators'] array
  1332.           Operators  available for search operations on character fields.
  1333.           Note  that  we  put  LIKE  by default instead of LIKE %...%, to
  1334.           avoid unintended performance problems in case of huge tables.
  1335.  
  1336.    $cfg['EnumOperators'] array
  1337.           Operators available for search operations on enum fields.
  1338.  
  1339.    $cfg['NullOperators'] array
  1340.           Additionnal  operators available for search operations when the
  1341.           field can be null.
  1342.  
  1343. Transformations
  1344.  
  1345.    Introduction  -  Usage  -  File structure
  1346.  
  1347.   [1. Introduction]
  1348.  
  1349.    To enable transformations, you have to setup the column_info table and
  1350.    the  proper directives. Please see the Configuration section on how to
  1351.    do so.
  1352.  
  1353.    You can apply different transformations to the contents of each field.
  1354.    The  transformation  will take the content of each field and transform
  1355.    it with certain rules defined in the selected transformation.
  1356.  
  1357.    Say  you  have  a field 'filename' which contains a filename. Normally
  1358.    you  would see in phpMyAdmin only this filename. Using transformations
  1359.    you  can  transform  that  filename into a HTML link, so you can click
  1360.    inside  of  the  phpMyAdmin structure on the field's link and will see
  1361.    the  file  displayed  in  a  new  browser window. Using transformation
  1362.    options  you can also specify strings to append/prepend to a string or
  1363.    the format you want the output stored in.
  1364.  
  1365.    For  a  general  overview  of  all available transformations and their
  1366.    options, you can consult your
  1367.    <www.your-host.com>/<your-install-dir>/libraries/transformations/overv
  1368.    iew.php installation.
  1369.  
  1370.    For a tutorial on how to effectively use transformations, see our Link
  1371.    section on the official phpMyAdmin-homepage.
  1372.  
  1373.   [2. Usage]
  1374.  
  1375.    Go  to your tbl_properties.inc.php page (i.e. reached through clicking
  1376.    on  the  'properties'  link  for a table). There click on "Change" (or
  1377.    change icon) and there you will see three new fields at the end of the
  1378.    line.  They  are  called  'MIME-type',  'Browser  transformation'  and
  1379.    'Transformation options'.
  1380.      * The field 'MIME-type' is a dropdown field. You have the options to
  1381.        leave  that  field empty or to use 'auto' [this feature is not yet
  1382.        available].  Please note that transformations are inactive as long
  1383.        as no MIME-type is selected.
  1384.      * The  field  'Browser transformation' is a drop-down field. You can
  1385.        choose   from   a   hopefully   growing   amount   of  pre-defined
  1386.        transformations.  See  below  for information on how to build your
  1387.        own transformation.
  1388.        There    are    global    transformations    and    mimetype-bound
  1389.        transformations.  Global  transformations  can  be  used  for  any
  1390.        mimetype.  They will take the mimetype, if necessary, into regard.
  1391.        Mimetype-bound  transformations  usually only operate on a certain
  1392.        mimetype.  There  are  transformations  which  operate on the main
  1393.        mimetype  (like  'image'), which will most likely take the subtype
  1394.        into  regard,  and  those  who  only operate on a specific subtype
  1395.        (like 'image/jpeg').
  1396.        You  can  use  transformations on mimetypes for which the function
  1397.        was  not  defined for. There is no security check for you selected
  1398.        the  right transformation, so take care of what the output will be
  1399.        like.
  1400.      * The  field  'Transformation options' is a free-type textfield. You
  1401.        have  to  enter  transform-function specific options here. Usually
  1402.        the  transforms  can  operate  with  default  options,  but  it is
  1403.        generally a good idea to look up the overview to see which options
  1404.        are necessary.
  1405.        Much  like  the  ENUM/SET-Fields,  you  have  to  split up several
  1406.        options using the format 'a','b','c',...(NOTE THE MISSING BLANKS).
  1407.        This is because internally the options will be parsed as an array,
  1408.        leaving  the  first  value  the first element in the array, and so
  1409.        forth.
  1410.        If  you  want to specify a MIME character set you can define it in
  1411.        the  transformation_options.  You  have to put that outside of the
  1412.        pre-defined  options  of  the specific mime-transform, as the last
  1413.        value  of  the set. Use the format "'; charset=XXX'". If you use a
  1414.        transform,  for  which  you  can specify 2 options and you want to
  1415.        append   a   character   set,   enter  "'first  parameter','second
  1416.        parameter','charset=us-ascii'".  You can, however use the defaults
  1417.        for the parameters: "'','','charset=us-ascii'".
  1418.  
  1419.   [3. File structure]
  1420.  
  1421.    All  mimetypes  and  their  transformations are defined through single
  1422.    files in the directory 'libraries/transformations/'.
  1423.  
  1424.    They  are  stored in files to ease up customization and easy adding of
  1425.    new transformations.
  1426.  
  1427.    Because  the  user  cannot  enter  own mimetypes, it is kept sure that
  1428.    transformations   always   work.   It   makes  no  sense  to  apply  a
  1429.    transformation  to  a mimetype, the transform-function doesn't know to
  1430.    handle.
  1431.  
  1432.    One  can,  however,  use  empty  mime-types and global transformations
  1433.    which should work for many mimetypes. You can also use transforms on a
  1434.    different  mimetype  they where built for, but pay attention to option
  1435.    usage as well as what the transformation does to your field.
  1436.  
  1437.    There  is  a  basic file called 'global.inc.php'. This function can be
  1438.    included  by  any  other  transform  function  and provides some basic
  1439.    functions.
  1440.  
  1441.    There are 5 possible file names:
  1442.     1. A mimetype+subtype transform:
  1443.        [mimetype]_[subtype]__[transform].inc.php
  1444.        Please  not that mimetype and subtype are separated via '_', which
  1445.        shall   not   be   contained   in   their   names.  The  transform
  1446.        function/filename  may  contain  only  characters  which  cause no
  1447.        problems  in  the  file  system as well as the PHP function naming
  1448.        convention.
  1449.        The transform function will the be called
  1450.        'PMA_transform_[mimetype]_[subtype]__[transform]()'.
  1451.        Example:
  1452.        text_html__formatted.inc.php
  1453.        PMA_transform_text_html__formatted()
  1454.     2. A mimetype (w/o subtype) transform:
  1455.        [mimetype]__[transform].inc.php
  1456.        Please note that there are no single '_' characters. The transform
  1457.        function/filename  may  contain  only  characters  which  cause no
  1458.        problems  in  the  file  system as well as the PHP function naming
  1459.        convention.
  1460.        The transform function will the be called
  1461.        'PMA_transform_[mimetype]__[transform]()'.
  1462.        Example:
  1463.        text__formatted.inc.php
  1464.        PMA_transform_text__formatted()
  1465.     3. A mimetype+subtype without specific transform function
  1466.        [mimetype]_[subtype].inc.php
  1467.        Please  note that there are no '__' characters in the filename. Do
  1468.        not  use  special characters in the filename causing problems with
  1469.        the file system.
  1470.        No transformation function is defined in the file itself.
  1471.        Example:
  1472.        text_plain.inc.php
  1473.        (No function)
  1474.     4. A mimetype (w/o subtype) without specific transform function
  1475.        [mimetype].inc.php
  1476.        Please  note  that there are no '_' characters in the filename. Do
  1477.        not  use  special characters in the filename causing problems with
  1478.        the file system.
  1479.        No transformation function is defined in the file itself.
  1480.        Example:
  1481.        text.inc.php
  1482.        (No function)
  1483.     5. A global transform function with no specific mimetype
  1484.        global__[transform].inc.php
  1485.        The transform function will the be called
  1486.        'PMA_transform_global__[transform]()'.
  1487.        Example:
  1488.        global__formatted
  1489.        PMA_transform_global__formatted()
  1490.  
  1491.    So  generally  use  '_'  to split up mimetype and subtype, and '__' to
  1492.    provide a transform function.
  1493.  
  1494.    All  filenames containing no '__' in themselves are not shown as valid
  1495.    transform functions in the dropdown.
  1496.  
  1497.    Please see the libraries/transformations/TEMPLATE file for adding your
  1498.    own transform function. See the
  1499.    libraries/transformations/TEMPLATE_MIMETYPE   for  adding  a  mimetype
  1500.    without a transform function. Also note the introduction of a function
  1501.    description   in   the   language   files.   For   each   function   a
  1502.    $strTransformation_[filename without .inc.php] has to exist.
  1503.  
  1504.    You  can  use  the  template  generator  to generate new functions and
  1505.    entries in the language file.
  1506.  
  1507.    To     create     a     new     transform    function    please    see
  1508.    libraries/transformations/template_generator.sh.   To  create  a  new,
  1509.    empty mimetype please see
  1510.    libraries/transformations/template_generator_mimetype.sh.
  1511.  
  1512.    A transform function always gets passed three variables:
  1513.     1. $buffer  -  Contains  the  text  inside of the column. This is the
  1514.        text, you want to transform.
  1515.     2. $options  -  Contains  any  user-passed  options  to  a  transform
  1516.        function as an array.
  1517.     3. $meta  - Contains an object with field information to your column.
  1518.        The  data  is  drawn  from  the  output of the mysql_fetch_field()
  1519.        function.  This  means,  all  object  properties  described on the
  1520.        manual  page  are  available  in  this variable and can be used to
  1521.        transform  a  field  accordingly to unsigned/zerofill/not_null/...
  1522.        properties.
  1523.        The  $meta->mimetype  variable  contains the original MIME-type of
  1524.        the field (i.e. 'text/plain', 'image/jpeg' etc.)
  1525.  
  1526. FAQ - Frequently Asked Questions
  1527.  
  1528.    Server   -   Configuration  -  Limitations  -  Multi-user  -  Browsers
  1529.    -  Usage tips  -  Project  -  Security
  1530.  
  1531.    Please  have  a  look  at  our Link section on the official phpMyAdmin
  1532.    homepage   for  in-depth  coverage  of  phpMyAdmin's  features  and/or
  1533.    interface.
  1534.  
  1535.   [1. Server]
  1536.  
  1537.     [1.1] I'm running PHP 4+ and my server is crashing each time a specific
  1538.     action is required or phpMyAdmin sends a blank page or a page full of
  1539.     cryptic characters to my browser, what can I do?
  1540.  
  1541.    There are some known PHP bugs with output buffering and compression.
  1542.    Try   to   set   the   $cfg['OBGzip']   directive  to  FALSE  in  your
  1543.    config.inc.php  file  and the zlib.output_compression directive to Off
  1544.    in your php configuration file.
  1545.    Furthermore,  we  know  about  such  problems connected to the release
  1546.    candidates  of  PHP  4.2.0 (tested with PHP 4.2.0 RC1 to RC4) together
  1547.    with  MS  Internet Explorer. Please upgrade to the release version PHP
  1548.    4.2.0.
  1549.  
  1550.     [1.2] My Apache server crashes when using phpMyAdmin.
  1551.  
  1552.    You  should  first  try  the  latest  versions of Apache (and possibly
  1553.    MySQL).
  1554.    See also the other FAQ entry about PHP bugs with output buffering.
  1555.    If  your  server  keeps  crashing,  please ask for help in the various
  1556.    Apache support groups.
  1557.  
  1558.     [1.3] I'm running phpMyAdmin with "cookie" authentication mode under PHP
  1559.     4.2.0 or 4.2.1 loaded as an Apache 2+ module but can't enter the script:
  1560.     I'm always displayed the login screen.
  1561.  
  1562.    This  is  a  known PHP bug (see this bug report) from the official PHP
  1563.    bug  database.  It  means  there  is  and  won't be any phpMyAdmin fix
  1564.    against it because there is no way to code a fix.
  1565.  
  1566.     [1.4] Using phpMyAdmin on IIS, I'm displayed the error message: "The
  1567.     specified CGI application misbehaved by not returning a complete set of
  1568.     HTTP headers...".
  1569.  
  1570.    You   just   forgot   to  read  the  install.txt  file  from  the  php
  1571.    distribution.  Have a look at the last message in this bug report from
  1572.    the official PHP bug database.
  1573.  
  1574.     [1.5] Using phpMyAdmin on IIS, I'm facing crashes and/or many error
  1575.     messages with the HTTP or advanced authentication mode.
  1576.  
  1577.    This is a known problem with the PHP ISAPI filter: it's not so stable.
  1578.    For  some  more  information  and  complete  testings see the messages
  1579.    posted  by AndrΘ B. aka "djdeluxe76" in this thread from the phpWizard
  1580.    forum.
  1581.    Please use instead the cookie authentication mode.
  1582.  
  1583.     [1.6] I can't use phpMyAdmin on PWS: nothing is displayed!
  1584.  
  1585.    This  seems  to be a PWS bug. Filippo Simoncini found a workaround (at
  1586.    this  time  there  is  no  better  fix): remove or comment the DOCTYPE
  1587.    declarations    (2    lines)    from   the   scripts   header.inc.php,
  1588.    header_printview.inc.php,        index.php,        left.php        and
  1589.    libraries/common.lib.php.
  1590.  
  1591.     [1.7] How can I GZip or Bzip a dump or a CSV export. It does not seem to
  1592.     work.
  1593.  
  1594.    These  features  are  based  on  the  gzencode()  and bzcompress() PHP
  1595.    functions  to  be more independent of the platform (Unix/Windows, Safe
  1596.    Mode  or  not,  and  so  on).  So,  you  must  have  PHP4 >= 4.0.4 and
  1597.    Zlib/Bzip2 support (--with-zlib and --with-bz2).
  1598.    We  faced  PHP crashes when trying to download a dump with MS Internet
  1599.    Explorer when phpMyAdmin is run with a release candidate of PHP 4.2.0.
  1600.    In this case you should switch to the release version of PHP 4.2.0.
  1601.  
  1602.     [1.8] I cannot insert a text file in a table, and I get an error about safe
  1603.     mode being in effect.
  1604.  
  1605.    Your  uploaded file is saved by PHP in the "upload dir", as defined in
  1606.    php.ini  by the variable upload_tmp_dir (usually the system default is
  1607.    /tmp).
  1608.    We  recommend  the  following setup for Apache servers running in safe
  1609.    mode, to enable uploads of files while being reasonably secure:
  1610.      * create a separate directory for uploads: mkdir /tmp/php
  1611.      * give   ownership   to   the   Apache  server's  user.group:  chown
  1612.        apache.apache /tmp/php
  1613.      * give proper permission: chmod 600 /tmp/php
  1614.      * put upload_tmp_dir = /tmp/php in php.ini
  1615.      * restart Apache
  1616.  
  1617.     [1.9] I'm having troubles when uploading files. In general file uploads
  1618.     don't work on my system and uploaded files have a Content-Type: header in
  1619.     the first line.
  1620.  
  1621.    It's  not  really phpMyAdmin related but RedHat 7.0. You have a RedHat
  1622.    7.0  and  you  updated your PHP RPM to php-4.0.4pl1-3.i386.rpm, didn't
  1623.    you?
  1624.    So  the  problem  is  that  this  package  has  a serious bug that was
  1625.    corrected  ages  ago in PHP (2001-01-28: see PHP's bug tracking system
  1626.    for  more  details).  The  problem is that the bugged package is still
  1627.    available  though  it  was  corrected  (see RedHat's BugZilla for more
  1628.    details).
  1629.    So  please  download  the  fixed  package (4.0.4pl1-9) and the problem
  1630.    should go away.
  1631.    And that fixes the \r\n problem with file uploads!
  1632.  
  1633.     [1.10] I'm having troubles when uploading files with phpMyAdmin running on
  1634.     a secure server. My browser is Internet Explorer and I'm using the Apache
  1635.     server.
  1636.  
  1637.    As  suggested by "Rob M" in the phpWizard forum, add this line to your
  1638.    httpd.conf:
  1639.        SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
  1640.    It seems to clear up many problems between Internet Explorer and SSL.
  1641.  
  1642.     [1.11] I get an 'open_basedir restriction' while uploading a file from the
  1643.     query box.
  1644.  
  1645.    Since  version  2.2.4,  phpMyAdmin  supports servers with open_basedir
  1646.    restrictions.  Assuming  that the restriction allows you to open files
  1647.    in  the  current directory ('.'), all you have to do is create a 'tmp'
  1648.    directory under the phpMyAdmin install directory, with permissions 777
  1649.    and  the  same  owner  as  the owner of your phpMyAdmin directory. The
  1650.    uploaded  files  will  be moved there, and after execution of your SQL
  1651.    commands, removed.
  1652.  
  1653.     [1.12] I have lost my MySQL root password, what can I do?
  1654.  
  1655.    The MySQL manual explains how to reset the permissions.
  1656.  
  1657.     [1.13] I get an error 'No SQL query' when trying to execute a bookmark.
  1658.  
  1659.    If  PHP  does  not  have  read/write  access to its upload_tmp_dir, it
  1660.    cannot access the uploaded query.
  1661.  
  1662.     [1.14] I get an error 'No SQL query' when trying to submit a query from the
  1663.     convenient text area.
  1664.  
  1665.    Check the post_max_size directive from your PHP configuration file and
  1666.    try to increase it.
  1667.  
  1668.     [1.15] I have problems with mysql.user field names.
  1669.  
  1670.    In  older MySQL versions, the User and Password fields were named user
  1671.    and  password.  Please  modify  your field names to align with current
  1672.    standards.
  1673.  
  1674.     [1.16] I cannot upload big dump files (memory, http or timeout problems).
  1675.  
  1676.    The first things to check (or ask your host provider to check) are the
  1677.    values  of  upload_max_filesize, memory_limit and post_max_size in the
  1678.    php.ini configuration file.
  1679.    All of these three settings limit the maximum size of data that can be
  1680.    submitted  and  handled  by PHP. One user also said that post_max_size
  1681.    and memory_limit need to be larger than upload_max_filesize.
  1682.    If you get a timeout problem, look at the $cfg['UploadDir'] feature.
  1683.  
  1684.     [1.17] Which MySQL versions does phpMyAdmin support?
  1685.  
  1686.    All  MySQL versions from 3.23.32 till 5.0 (except for 4.1.0 and 4.1.1)
  1687.    are fully supported. Please note that the older your MySQL version is,
  1688.    the more limitations you will have to face.
  1689.    phpMyAdmin  may connect to your MySQL server using php's classic MySQL
  1690.    extension  as  well  as  the improved MySQL extension (MySQLi) that is
  1691.    available in php 5.0.
  1692.    Either  way,  the  developers  of both extensions recommend to use the
  1693.    classic extension for MySQL 4.0 and below and MySQLi for MySQL 4.1 and
  1694.    newer.
  1695.    When  compiling  php, we strongly recommend that you manually link the
  1696.    MySQL  extension  of your choice to a MySQL client library of at least
  1697.    the  same  minor  version  since the one that is bundled with some php
  1698.    distributions  is  rather  old  and might cause problems (see also FAQ
  1699.    1.17a).
  1700.    MySQL 5.1 is not yet supported.
  1701.  
  1702.     [1.17a] I cannot connect to the MySQL server. It alaways returns the error
  1703.     message, "Client does not support authentication protocol requested by
  1704.     server; consider upgrading MySQL client"
  1705.  
  1706.    You  tried  to  access  MySQL  with  an  old MySQL client library. The
  1707.    version  of your MySQL client library can be checked in your phpinfo()
  1708.    output.
  1709.    In  general,  it  should  have at least the same minor version as your
  1710.    server - as mentioned in FAQ 1.17.
  1711.    The  only  way  to  fix this problem is manually compiling php and its
  1712.    MySQL extension against a current MySQL client library.
  1713.    If  you  still  face  this  problem,  please compile your MySQL client
  1714.    library against the same or a newer MySQL release.
  1715.  
  1716.     [1.18] I'm running MySQL <= 4.0.1 having lower_case_table_names set to 1.
  1717.     If I create a new table with a capital letter in its name it is changed to
  1718.     lowercase as it should. But if I try to DROP this table MySQL is unable to
  1719.     find the corresponding file.
  1720.  
  1721.    This   is  a  bug  of  MySQL <= 4.0.1.  Please  upgrade  to  at  least
  1722.    MySQL 4.0.2 or turn off your lower_case_table_names directive.
  1723.  
  1724.     [1.19] I can't run the "display relations" feature because the script seems
  1725.     not to know the font face I'm using!
  1726.  
  1727.    The  "FPDF" library we're using for this feature requires some special
  1728.    files to use font faces.
  1729.    Please refers to the FPDF manual to build these files.
  1730.  
  1731.     [1.20] I receive the error "cannot load MySQL extension, please check PHP
  1732.     Configuration".
  1733.  
  1734.    To  connect  to  a  MySQL  server,  PHP needs a set of MySQL functions
  1735.    called  "MySQL  extension".  This  extension  may  be  part of the PHP
  1736.    distribution   (compiled-in),   otherwise   it   needs  to  be  loaded
  1737.    dynamically.   Its   name   is  probably  mysql.so  or  php_mysql.dll.
  1738.    phpMyAdmin tried to load the extension but failed.
  1739.    Usually, the problem is solved by installing a software package called
  1740.    "PHP-MySQL" or something similar.
  1741.  
  1742.     [1.21] I am running the CGI version of PHP under Unix, and I cannot login
  1743.     using cookie auth.
  1744.  
  1745.    In php.ini, set mysql.max_links higher than 1.
  1746.  
  1747.     [1.22] I don't see the "Location of text file" field, so I cannot upload.
  1748.  
  1749.    This is most likely because in php.ini, your file_uploads parameter is
  1750.    not set to "on".
  1751.  
  1752.     [1.23] I'm running MySQL on a Win32 machine. Each time I create a new table
  1753.     the table and field names are changed to lowercase!
  1754.  
  1755.    This   happens  because  the  MySQL  directive  lower_case_table_names
  1756.    defaults  to 1 (ON) in the Win32 version of MySQL. You can change this
  1757.    behavior by simply changing the directive to 0 (OFF):
  1758.    Just  edit  your  my.ini  file  that should be located in your Windows
  1759.    directory and add the following line to the group [mysqld]:
  1760.    set-variable = lower_case_table_names=0
  1761.    Next,  save  the  file  and  restart the MySQL service. You can always
  1762.    check the value of this directive using the query
  1763.    SHOW VARIABLES LIKE 'lower_case_table_names';
  1764.  
  1765.     [1.24] Some characters are being truncated in my queries, or I get
  1766.     characters randomly added. I am running PHP 4.2.3.
  1767.  
  1768.    This is a PHP 4.2.3 bug.
  1769.  
  1770.     [1.25] I am running Apache with mod_gzip-1.3.26.1a on Windows XP, and I get
  1771.     problems, such as undefined variables when I run a SQL query.
  1772.  
  1773.    A  tip  from  Jose Fandos: put a comment on the following two lines in
  1774.    httpd.conf, like this:
  1775.    # mod_gzip_item_include file \.php$
  1776.    # mod_gzip_item_include mime "application/x-httpd-php.*"
  1777.    as  this version of mod_gzip on Apache (Windows) has problems handling
  1778.    PHP scripts. Of course you have to restart Apache.
  1779.  
  1780.     [1.26] I just installed phpMyAdmin in my document root of IIS but I get the
  1781.     error "No input file specified" when trying to run phpMyAdmin.
  1782.  
  1783.    This is a permission problem. Right-click on the phpmyadmin folder and
  1784.    choose  properties.  Under the tab Security, click on "Add" and select
  1785.    the  user "IUSR_machine" from the list. Now set his permissions and it
  1786.    should work.
  1787.  
  1788.     [1.27] I get empty page when I want to view huge page (eg.
  1789.     db_details_structure.php with plenty of tables).
  1790.  
  1791.    This is a PHP bug that occur when GZIP output buffering is enabled. If
  1792.    you  turn  off  it  (by  $cfg['OBGzip'] = FALSE in config.inc.php), it
  1793.    should work. This bug will be fixed in PHP 5.0.0.
  1794.  
  1795.     [1.28] My MySQL server sometimes refuses queries and returns the message
  1796.     'Errorcode: 13'. What does this mean?
  1797.  
  1798.    This  can happen due to a MySQL bug when having database / table names
  1799.    with  upper  case characters although lower_case_table_names is set to
  1800.    1.  To  fix  this,  turn  off this directive, convert all database and
  1801.    table names to lower case and turn it on again. Alternatively, there's
  1802.    a bug-fix available starting with MySQL 3.23.56 / 4.0.11-gamma.
  1803.  
  1804.     [1.29] When I create a table or modify a field, I get an error and the
  1805.     fields are duplicated.
  1806.  
  1807.    It is possible to configure Apache in such a way that PHP has problems
  1808.    interpreting .php files.
  1809.    The  problems  occur  when  two  different  (and  conflicting)  set of
  1810.    directives are used:
  1811.    SetOutputFilter PHP
  1812.    SetInputFilter PHP
  1813.    &
  1814.    AddType application/x-httpd-php .php
  1815.    In    the    case   we   saw,   one   set   of   directives   was   in
  1816.    /etc/httpd/conf/httpd.conf,    while    the    other    set   was   in
  1817.    /etc/httpd/conf/addon-modules/php.conf.
  1818.    The recommended way is with AddType, so just comment out the first set
  1819.    of lines and restart Apache:
  1820.    #SetOutputFilter PHP
  1821.    #SetInputFilter PHP
  1822.    
  1823.     [1.30] I get the error "left.php: Missing hash".
  1824.  
  1825.    This  problem  is  known  to  happen  when the server is running Turck
  1826.    MMCache but upgrading MMCache to version 2.3.21 solves the problem.
  1827.  
  1828.     [1.31] Does phpMyAdmin support php5?
  1829.  
  1830.    Yes.
  1831.    However,  phpMyAdmin needs to be backwards compatible to php4. This is
  1832.    why  you  won't  be  able to run phpMyAdmin having enabled E_STRICT in
  1833.    your error_reporting settings.
  1834.  
  1835.   [2. Configuration]
  1836.  
  1837.     [2.1] The error message "Warning: Cannot add header information - headers
  1838.     already sent by ..." is displayed, what's the problem?
  1839.  
  1840.    Edit  your  config.inc.php  or  .php  file and ensure there is nothing
  1841.    (I.E.  no blank lines, no spaces, no characters...) neither before the
  1842.    <?php tag at the beginning, neither after the ?> tag at the end.
  1843.  
  1844.     [2.2] phpMyAdmin can't connect to MySQL. What's wrong?
  1845.  
  1846.    Either there is an error with your PHP setup or your username/password
  1847.    is  wrong. Try to make a small script which uses mysql_connect and see
  1848.    if  it works. If it doesn't, it may be you haven't even compiled MySQL
  1849.    support into PHP.
  1850.  
  1851.     [2.3] The error message "Warning: MySQL Connection Failed: Can't connect to
  1852.     local MySQL server through socket '/tmp/mysql.sock' (111)..." is displayed.
  1853.     What can I do?
  1854.  
  1855.    For RedHat users, Harald Legner suggests this on the mailing list:
  1856.    On  my RedHat-Box the socket of MySQL is /var/lib/mysql/mysql.sock. In
  1857.    your php.ini you will find a line
  1858.        mysql.default_socket = /tmp/mysql.sock
  1859.    change it to
  1860.        mysql.default_socket = /var/lib/mysql/mysql.sock
  1861.    Then restart apache and it will work.
  1862.    Here is a fix suggested by Brad Ummer in the phpwizard forum:
  1863.      * First, you need to determine what socket is being used by MySQL.
  1864.        To  do  this,  telnet  to  your  server  and  go  to the MySQL bin
  1865.        directory.  In  this  directory  there  should  be  a  file  named
  1866.        mysqladmin.  Type ./mysqladmin variables, and this should give you
  1867.        a  bunch  of  info  about  your MySQL server, including the socket
  1868.        (/tmp/mysql.sock, for example).
  1869.      * Then, you need to tell PHP to use this socket.
  1870.        Assuming  you  are using PHP 3.0.10 or better, you can specify the
  1871.        socket  to  use  when  you  open  the  connection.  To  do this in
  1872.        phpMyAdmin,  you  need  to  complete the socket information in the
  1873.        config.inc.php.
  1874.        For example: $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';
  1875.        Please  also  make sure that the permissions of this file allow to
  1876.        be readable by your webserver (i.e. '0755').
  1877.  
  1878.    Have   also   a  look  at  the  corresponding  section  of  the  MySQL
  1879.    documentation.
  1880.  
  1881.     [2.4] Nothing is displayed by my browser when I try to run phpMyAdmin, what
  1882.     can I do?
  1883.  
  1884.    Try  to  set  the  $cfg['OBGZip'] directive to FALSE in the phpMyAdmin
  1885.    configuration file. It helps sometime.
  1886.    Also  have a look at your PHP version number: if it contains "4.0b..."
  1887.    it  means  you're  running a beta version of PHP. That's not a so good
  1888.    idea, please upgrade to a plain revision.
  1889.  
  1890.     [2.5] Each time I want to insert or change a record or drop a database or a
  1891.     table, an error 404 (page not found) is displayed or, with HTTP or cookie
  1892.     authentication, I'm asked to login again. What's wrong?
  1893.  
  1894.    Check  the  value  you set for the $cfg['PmaAbsoluteUri'] directive in
  1895.    the phpMyAdmin configuration file.
  1896.  
  1897.     [2.6] I get an "Access denied for user: 'root@localhost' (Using password:
  1898.     YES)"-error when trying to access a MySQL-Server on a host which is
  1899.     port-forwarded for my localhost.
  1900.  
  1901.    When  you  are  using a port on your localhost, which you redirect via
  1902.    port-forwarding  to another host, MySQL is not resolving the localhost
  1903.    as expected.
  1904.    Erik  Wasser  explains:  The  solution is: if your host is "localhost"
  1905.    MySQL  (the  commandline tool 'mysql' as well) always tries to use the
  1906.    socket  connection  for  speeding  up things. And that doesn't work in
  1907.    this configuration with port forwarding.
  1908.    If  you  enter  "127.0.0.1" as hostname, everything is right and MySQL
  1909.    uses the TCP connection.
  1910.  
  1911.     [2.7] Using and creating themes
  1912.  
  1913.    Themes are configured with $cfg['ThemePath'], $cfg['ThemeManager'] and
  1914.    $cfg['ThemeDefault'].
  1915.    Under   $cfg['ThemePath'],   you   should  not  delete  the  directory
  1916.    "original"  or  its  underlying  structure, because this is the system
  1917.    theme  used  by phpMyAdmin. "original" contains all images and styles,
  1918.    for  backwards compatibility and for all themes that would not include
  1919.    images or css-files.
  1920.    If $cfg['ThemeManager'] is enabled, you can select your favorite theme
  1921.    on the main page. Your selected theme will be stored in a cookie.
  1922.  
  1923.    To create a theme:
  1924.      * make  a  new  subdirectory  (for  example "your_theme_name") under
  1925.        $cfg['ThemePath'] (by default themes)
  1926.      * copy    the    files    and   directories   from   "original"   to
  1927.        "your_theme_name"
  1928.      * edit the css-files in "your_theme_name/css"
  1929.      * put your new images in "your_theme_name/img"
  1930.      * edit layout.inc.php in "your_theme_name"
  1931.      * edit  info.inc.php  in  "your_theme_name"  to  contain your chosen
  1932.        theme name, that will be visible in user interface
  1933.      * make   a   new   screenshot  of  your  theme  and  save  it  under
  1934.        "your_theme_name/screen.png"
  1935.  
  1936.    In  theme  directory  there  is file info.inc.php which contains theme
  1937.    verbose  name,  theme generation and theme version. These versions and
  1938.    generations  are  enumerated  from  1  and  do  not  have  any  direct
  1939.    dependance on phpMyAdmin version. Themes within same generation should
  1940.    be bacward compatible - theme with version 2 should work in phpMyAdmin
  1941.    requiring   version   1.   Themes   with   different   generation  are
  1942.    incompatible.
  1943.  
  1944.    If  you  do  not  want to use your own symbols and buttons, remove the
  1945.    directory  "img" in "your_theme_name". phpMyAdmin will use the default
  1946.    icons and buttons (from the system-theme "original").
  1947.  
  1948.   [3. Known limitations]
  1949.  
  1950.     [3.1] When using HTTP authentication, an user who logged out can not
  1951.     relogin in with the same nick.
  1952.  
  1953.    This  is  related  to  the authentication mechanism (protocol) used by
  1954.    phpMyAdmin.  To bypass this problem: just close all the opened browser
  1955.    windows  and  then go back to phpMyAdmin. You should be able to log in
  1956.    again.
  1957.  
  1958.     [3.2] When dumping a large table in compressed mode, I get a memory limit
  1959.     error or a time limit error.
  1960.  
  1961.    Compressed  dumps  are built in memory and because of this are limited
  1962.    to  php's  memory  limit.  For GZip/BZip2 exports this can be overcome
  1963.    since  2.5.4  using  $cfg['CompressOnFly']  (enabled  by default). Zip
  1964.    exports  can  not  be  handled  this way, so if you need Zip files for
  1965.    larger dump, you have to use another way.
  1966.  
  1967.     [3.3] With InnoDB tables, I lose foreign key relationships when I rename or
  1968.     alter a table.
  1969.  
  1970.    This seems to be a InnoDB bug (fixed in MySQL 3.23.50?).
  1971.  
  1972.     [3.4] I am unable to import dumps I created with the mysqldump tool bundled
  1973.     with the MySQL server distribution.
  1974.  
  1975.    The problem is that mysqldump creates invalid comments like this:
  1976. -- MySQL dump 8.22
  1977. --
  1978. -- Host: localhost Database: database
  1979. ---------------------------------------------------------
  1980. -- Server version 3.23.54
  1981.  
  1982.    The  invalid  part  of  the code is the horizontal line made of dashes
  1983.    that appears once in every dump created with mysqldump. If you want to
  1984.    run  your  dump  you have to turn it into valid MySQL. This means, you
  1985.    have to add a whitespace after the first two dashes of the line or add
  1986.    a # before it:
  1987.    -- -------------------------------------------------------
  1988.    or
  1989.    #---------------------------------------------------------
  1990.  
  1991.     [3.5] When using nested folders ($cfg['LeftFrameTableSeparator']) there are
  1992.     some multiple hierarchies displayed in a wrong manner?!
  1993.  
  1994.    Please  note  that  you  should not use the separating string multiple
  1995.    times  without any characters between them, or at the beginning/end of
  1996.    your   table   name.  If  you  have  to,  think  about  using  another
  1997.    TableSeparator or disabling that feature
  1998.  
  1999.     [3.6] What is currently not supported in phpMyAdmin about InnoDB?
  2000.  
  2001.    In Relation view, being able to choose a table in another database, or
  2002.    having more than one index field in the foreign key.
  2003.    In  Query-by-example  (Query),  automatic generation of the query LEFT
  2004.    JOIN from the foreign table.
  2005.    In PDF schema editing, automatic layout.
  2006.  
  2007.     [3.7] I have table with many (100+) fields and when I try to browse table I
  2008.     get series of errors like "Warning: unable to parse url". How can this be
  2009.     fixed?
  2010.  
  2011.    Your  table  neither  have a primary key nor an unique one, so we must
  2012.    use  a  long  expression to identify this row. This causes problems to
  2013.    parse_url  function.  The  workaround is to create a primary or unique
  2014.    key.
  2015.  
  2016.     [3.8] I cannot use (clickable) HTML-forms in fields where I put a
  2017.     MIME-Transformation onto!
  2018.  
  2019.    Due to a surrounding form-container (for multi-row delete checkboxes),
  2020.    no  nested forms can be put inside the table where phpMyAdmin displays
  2021.    the  results. You can, however, use any form inside of a table if keep
  2022.    the  parent  form-container  with the target to tbl_row_delete.php and
  2023.    just  put  your  own input-elements inside. If you use a custom submit
  2024.    input field, the form will submit itself to the displaying page again,
  2025.    where  you can validate the $HTTP_POST_VARS in a transformation. For a
  2026.    tutorial  on  how  to  effectively  use  transformations, see our Link
  2027.    section on the official phpMyAdmin-homepage.
  2028.  
  2029.     [3.9] I get error messages when using "--sql_mode=ANSI" for the MySQL
  2030.     server
  2031.  
  2032.    When MySQL is running in ANSI-compatibility mode, there are some major
  2033.    differences in how SQL is structured (see
  2034.    http://dev.mysql.com/doc/mysql/en/ANSI_mode.html).  Most  important of
  2035.    all,  the  quote-character  (")  is interpreted as an identifier quote
  2036.    character  and  not  as  a  string  quote  character, which makes many
  2037.    internal  phpMyAdmin  operations into invalid SQL statements. There is
  2038.    no  workaround  to this behaviour. News to this item will be posted in
  2039.    Bug report #816858
  2040.  
  2041.     [3.10] Homonyms and no primary key: When the results of a SELECT display
  2042.     more that one column with the same value (for example SELECT lastname from
  2043.     employees where firstname like 'A%' and two "Smith" values are displayed),
  2044.     if I click Edit I cannot be sure that I am editing the intended row.
  2045.  
  2046.    Please make sure that your table has a primary key, so that phpMyAdmin
  2047.    can use it for the Edit and Delete links.
  2048.  
  2049.   [4. ISPs, multi-user installations ]
  2050.  
  2051.     [4.1] I'm an ISP. Can I setup one central copy of phpMyAdmin or do I need
  2052.     to install it for each customer.
  2053.  
  2054.    Since  version  2.0.3,  you can setup a central copy of phpMyAdmin for
  2055.    all  your  users. The development of this feature was kindly sponsored
  2056.    by  NetCologne  GmbH.  This  requires  a  properly  setup  MySQL  user
  2057.    management  and  phpMyAdmin  HTTP  or  cookie  authentication. See the
  2058.    install section on "Using HTTP authentication".
  2059.  
  2060.     [4.2] What's the preferred way of making phpMyAdmin secure against evil
  2061.     access.
  2062.  
  2063.    This depends on your system.
  2064.    If  you're  running a server which cannot be accessed by other people,
  2065.    it's  sufficient  to  use  the  directory protection bundled with your
  2066.    webserver (with Apache you can use .htaccess files, for example).
  2067.    If  other  people  have  telnet  access to your server, you should use
  2068.    phpMyAdmin's HTTP authentication feature.
  2069.    Suggestions:
  2070.      * Your config.inc.php file should be chmod 660.
  2071.      * All  your  phpMyAdmin files should be chown -R phpmy.apache, where
  2072.        phpmy is a user whose password is only known to you, and apache is
  2073.        the group under which Apache runs.
  2074.      * You should use PHP safe mode, to protect from other users that try
  2075.        to include your config.inc.php in their scripts.
  2076.  
  2077.     [4.3] I get errors about not being able to include a file in /lang or in
  2078.     /libraries.
  2079.  
  2080.    Check php.ini, or ask your sysadmin to check it. The include_path must
  2081.    contain  "."  somewhere in it, and open_basedir, if used, must contain
  2082.    "." and "./lang" to allow normal operation of phpMyAdmin.
  2083.  
  2084.     [4.4] phpMyAdmin always gives "Access denied" when using HTTP
  2085.     authentication.
  2086.  
  2087.    This could happen for several reasons:
  2088.      * $cfg['Servers'][$i]['controluser']                          and/or
  2089.        $cfg['Servers'][$i]['controlpass'] are wrong.
  2090.      * The username/password you specify in the login-dialog are invalid.
  2091.      * You   have   already   setup   a   security   mechanism   for  the
  2092.        phpMyAdmin-directory,  eg.  a .htaccess file. This would interfere
  2093.        with phpMyAdmin's authentication, so remove it.
  2094.  
  2095.     [4.5] Is it possible to let users create their own databases?
  2096.  
  2097.    Starting  with  2.2.5,  in  the  user management page, you can enter a
  2098.    wildcard  database  name  for a user (for example "joe%"), and put the
  2099.    privileges  you  want.  For  example,  adding  SELECT, INSERT, UPDATE,
  2100.    DELETE,  CREATE,  DROP,  INDEX,  ALTER  would let a user create/manage
  2101.    his/her database(s).
  2102.  
  2103.     [4.6] How can I use the Host-based authentication additions?
  2104.  
  2105.    If  you  have  existing rules from an old .htaccess file, you can take
  2106.    them and add a username between the 'deny'/'allow' and 'from' strings.
  2107.    Using  the  username  wildcard of '%' would be a major benefit here if
  2108.    your  installation  is suited to using it. Then you can just add those
  2109.    updated   lines   into  the  $cfg['Servers'][$i]['AllowDeny']['rules']
  2110.    array.
  2111.    If you want a pre-made sample, you can try this fragment. It stops the
  2112.    'root'  user  from logging in from any networks other than the private
  2113.    network IP blocks.
  2114.        //block root from logging in except from the private networks
  2115.        $cfg['Servers'][$i]['AllowDeny']['order'] = 'deny,allow';
  2116.        $cfg['Servers'][$i]['AllowDeny']['rules'] = array(
  2117.            'deny root from all',
  2118.            'allow root from localhost',
  2119.            'allow root from 10.0.0.0/8',
  2120.            'allow root from 192.168.0.0/16',
  2121.            'allow root from 172.16.0.0/12',
  2122.            );
  2123.  
  2124.     [4.7] Authentication window is displayed more than once, why?
  2125.  
  2126.    This  happens  if  you  are  using  a URL to start phpMyAdmin which is
  2127.    different  than  the  one  set  in  your  $cfg['PmaAbsoluteUri'].  For
  2128.    example,  a  missing  "www",  or  entering  with an IP address while a
  2129.    domain name is defined in the config file.
  2130.  
  2131.   [5. Browsers or client OS]
  2132.  
  2133.     [5.1] I get an out of memory error, and my controls are non-functional,
  2134.     when trying to create a table with more than 14 fields.
  2135.  
  2136.    We  could  reproduce this problem only under Win98/98SE. Testing under
  2137.    WinNT4 or Win2K, we could easily create more than 60 fields.
  2138.    A  workaround  is to create a smaller number of fields, then come back
  2139.    to your table properties and add the other fields.
  2140.  
  2141.     [5.2] With Xitami 2.5b4, phpMyAdmin won't process form fields.
  2142.  
  2143.    This  is  not a phpMyAdmin problem but a Xitami known bug: you'll face
  2144.    it with each script/website that use forms.
  2145.    Upgrade or downgrade your Xitami server.
  2146.  
  2147.     [5.3] I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2).
  2148.  
  2149.    With  Konqueror 2.1.1: plain dumps, zip and GZip dumps work ok, except
  2150.    that  the  proposed  file  name for the dump is always 'tbl_dump.php'.
  2151.    Bzip2 dumps don't seem to work.
  2152.    With  Konqueror 2.2.1: plain dumps work; zip dumps are placed into the
  2153.    user's  temporary  directory,  so  they  must  be moved before closing
  2154.    Konqueror, or else they disappear. GZip dumps give an error message.
  2155.    Testing needs to be done for Konqueror 2.2.2.
  2156.  
  2157.     [5.4] I can't use the cookie authentication mode because Internet Explorer
  2158.     never stores the cookies.
  2159.  
  2160.    MS  Internet Explorer seems to be really buggy about cookies, at least
  2161.    till  version  6. And thanks to Andrew Zivolup we've traced also a PHP
  2162.    4.1.1 bug in this area!
  2163.    Then,  if  you're running PHP 4.1.1, try to upgrade or downgrade... it
  2164.    may work!
  2165.  
  2166.     [5.5] In Internet Explorer 5.0, I get JavaScript errors when browsing my
  2167.     rows.
  2168.  
  2169.    Upgrade to at least Internet Explorer 5.5 SP2.
  2170.  
  2171.     [5.6] In Internet Explorer 5.0, 5.5 or 6.0, I get an error (like "Page not
  2172.     found") when trying to modify a row in a table with many fields, or with a
  2173.     text field
  2174.  
  2175.    Your  table  neither  have a primary key nor an unique one, so we must
  2176.    use a long URL to identify this row. There is a limit on the length of
  2177.    the  URL  in  those  browsers,  and  this  not happen in Netscape, for
  2178.    example.  The  workaround is to create a primary or unique key, or use
  2179.    another browser.
  2180.  
  2181.     [5.7] I refresh (reload) my browser, and come back to the welcome page.
  2182.  
  2183.    Some  browsers  support  right-clicking  into  the  frame  you want to
  2184.    refresh, just do this in the right frame.
  2185.  
  2186.     [5.8] With Mozilla 0.9.7 I have problems sending a query modified in the
  2187.     query box.
  2188.  
  2189.    Looks  like a Mozilla bug: 0.9.6 was OK. We will keep an eye on future
  2190.    Mozilla versions.
  2191.  
  2192.     [5.9] With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can't type a
  2193.     whitespace in the SQL-Query edit area: the page scrolls down.
  2194.  
  2195.    This is a Mozilla bug (see bug #26882 at BugZilla).
  2196.  
  2197.     [5.10] With Netscape 4.75 I get empty rows between each row of data in a
  2198.     CSV exported file.
  2199.  
  2200.    This  is  a  known  Netscape  4.75  bug:  it adds some line feeds when
  2201.    exporting  data  in  octet-stream  mode.  Since  we  can't  detect the
  2202.    specific Netscape version, we cannot workaround this bug.
  2203.  
  2204.     [5.11] Extended-ASCII characters like German umlauts are displayed wrong.
  2205.  
  2206.    Please  ensure  that  you have set your browser's character set to the
  2207.    one of the language file you have selected on phpMyAdmin's start page.
  2208.    Alternatively,  you  can try the auto detection mode that is supported
  2209.    by the recent versions of the most browsers.
  2210.  
  2211.     [5.12] Apple OS X: Safari browser changes special characters to "?".
  2212.  
  2213.    This  issue  has  been reported by a OS X user, who adds that Chimera,
  2214.    Netscape and Mozilla do not have this problem.
  2215.  
  2216.     [5.13] With Internet Explorer 5.5 or 6, and HTTP authentication type, I
  2217.     cannot manage two servers: I login to the first one, then the other one,
  2218.     but if I switch back to the first, I have to login on each operation.
  2219.  
  2220.    This  is a bug in Internet Explorer, other browsers do not behave this
  2221.    way.
  2222.  
  2223.     [5.14] Using Opera6, I can manage to get to the authentication, but nothing
  2224.     happens after that, only a blank screen.
  2225.  
  2226.    Having  $cfg['QueryFrameJS']  set  to  TRUE,  this  leads  to a bug in
  2227.    Opera6,  because  it  is  not  able to interpret frameset definitiions
  2228.    written by JavaScript. Please upgrade to Opera7 at least.
  2229.  
  2230.     [5.15] I have display problems with Safari.
  2231.  
  2232.    Please upgrade to at least version 1.2.3.
  2233.  
  2234.   [6. Using phpMyAdmin]
  2235.  
  2236.     [6.1] I can't insert new rows into a table / I can't create a table - MySQL
  2237.     brings up a SQL-error.
  2238.  
  2239.    Examine  the  SQL  error  with  care.  Often  the problem is caused by
  2240.    specifying a wrong field-type.
  2241.    Common errors include:
  2242.      * Using VARCHAR without a size argument
  2243.      * Using TEXT or BLOB with a size argument
  2244.  
  2245.    Also,  look  at the syntax chapter in the MySQL manual to confirm that
  2246.    your syntax is correct.
  2247.  
  2248.     [6.2] When I create a table, I click the Index checkbox for 2 fields and
  2249.     phpMyAdmin generates only one index with those 2 fields.
  2250.  
  2251.    In   phpMyAdmin  2.2.0  and  2.2.1,  this  is  the  way  to  create  a
  2252.    multi-fields index. If you want two indexes, create the first one when
  2253.    creating  the table, save, then display the table properties and click
  2254.    the Index link to create the other index.
  2255.  
  2256.     [6.3] How can I insert a null value into my table?
  2257.  
  2258.    Since  version  2.2.3,  you have a checkbox for each field that can be
  2259.    null.  Before  2.2.3,  you had to enter "null", without the quotes, as
  2260.    the  field's  value. Since version 2.5.5, you have to use the checkbox
  2261.    to get a real NULL value, so if you enter "NULL" this means you want a
  2262.    literal NULL in the field, and not a NULL value (this works in PHP4).
  2263.  
  2264.     [6.4] How can I backup my database or table?
  2265.  
  2266.    Click  on  a  database or table name in the left frame, the properties
  2267.    will  be displayed. Then on the menu, click "Export", you can dump the
  2268.    structure,  the  data,  or  both.  This  will  generate  standard  SQL
  2269.    statements that can be used to recreate your database/table.
  2270.    You  will  need  to  choose  "Save  as  file",  so that phpMyAdmin can
  2271.    transmit  the  resulting  dump  to your station. Depending on your PHP
  2272.    configuration, you will see options to compress the dump. See also the
  2273.    $cfg['ExecTimeLimit'] configuration variable.
  2274.    For  additional help on this subject, look for the word "dump" in this
  2275.    document.
  2276.  
  2277.     [6.5] How can I restore (upload) my database or table using a dump? How can
  2278.     I run a ".sql" file.
  2279.  
  2280.    Click  on  a  database  name in the left frame, the properties will be
  2281.    local  displayed.  Then  in  the "Run SQL query" section, type in your
  2282.    dump filename, or use the Browse button. Then click Go.
  2283.    For  additional  help  on  this subject, look for the word "upload" in
  2284.    this document.
  2285.  
  2286.     [6.6] How can I use the relation table in Query-by-example?
  2287.  
  2288.    Here  is  an example with the tables persons, towns and countries, all
  2289.    located  in the database mydb. If you don't have a pma_relation table,
  2290.    create  it  as explained in the configuration section. Then create the
  2291.    example tables:
  2292.         CREATE TABLE REL_countries (
  2293.           country_code char(1) NOT NULL default '',
  2294.           description varchar(10) NOT NULL default '',
  2295.           PRIMARY KEY (country_code)
  2296.         ) TYPE=MyISAM;
  2297.         INSERT INTO REL_countries VALUES ('C', 'Canada');
  2298.         CREATE TABLE REL_persons (
  2299.           id tinyint(4) NOT NULL auto_increment,
  2300.           person_name varchar(32) NOT NULL default '',
  2301.           town_code varchar(5) default '0',
  2302.           country_code char(1) NOT NULL default '',
  2303.           PRIMARY KEY (id)
  2304.         ) TYPE=MyISAM;
  2305.         INSERT INTO REL_persons VALUES (11, 'Marc', 'S', '');
  2306.         INSERT INTO REL_persons VALUES (15, 'Paul', 'S', 'C');
  2307.         CREATE TABLE REL_towns (
  2308.           town_code varchar(5) NOT NULL default '0',
  2309.           description varchar(30) NOT NULL default '',
  2310.           PRIMARY KEY (town_code)
  2311.         ) TYPE=MyISAM;
  2312.         INSERT INTO REL_towns VALUES ('S', 'Sherbrooke');
  2313.         INSERT INTO REL_towns VALUES ('M', 'MontrΘal');
  2314.    To setup appropriate links and display information:
  2315.      * on table "REL_persons" click Structure, then Relation view
  2316.      * in Links, for "town_code" choose "REL_towns->code"
  2317.      * in Links, for "country_code" choose "REL_countries->country_code"
  2318.      * on table "REL_towns" click Structure, then Relation view
  2319.      * in "Choose field to display", choose "description"
  2320.      * repeat the two previous steps for table "REL_countries"
  2321.  
  2322.    Then test like this:
  2323.      * Click on your db name in the left frame
  2324.      * Choose "Query"
  2325.      * Use tables: persons, towns, countries
  2326.      * Click "Update query"
  2327.      * In the fields row, choose persons.person_name and click the "Show"
  2328.        tickbox
  2329.      * Do  the  same  for towns.description and countries.descriptions in
  2330.        the other 2 columns
  2331.      * Click  "Update  query"  and you will see in the query box that the
  2332.        correct joins have been generated
  2333.      * Click "Submit query"
  2334.  
  2335.     [6.7] How can I use the "display field" feature?
  2336.  
  2337.    Starting  from  the  previous  example,  create  the pma_table_info as
  2338.    explained  in  the  configuration  section,  then  browse your persons
  2339.    table, and move the mouse over a town code or country code.
  2340.    See  also  FAQ  6.21  for  an additionnal feature that "display field"
  2341.    enables: drop-down list of possible values.
  2342.  
  2343.     [6.8] How can I produce a PDF schema of my database?
  2344.  
  2345.    First  you have to fill the "relation", "table_coords" and "pdf_pages"
  2346.    configuration variables.
  2347.    Then,  think  about  your schema layout: which tables will go on which
  2348.    pages.
  2349.      * Click on your db name in the left frame
  2350.      * Choose "Structure" in the navigation on top
  2351.      * Choose "Edit PDF Pages" which should be somewhere at the bottom of
  2352.        the page
  2353.      * Enter  the  name for a first pdf page and submit (you can also use
  2354.        the  "Automatic  layout",  which  will  place on your page all the
  2355.        tables that are linked)
  2356.      * Choose this page to edit
  2357.      * Now  add a table you want to show on this page and its coordinates
  2358.        and submit
  2359.        First  you will have to guess those coordinates of course, so just
  2360.        expect  to  have  an  area  of  about 297 * 210 and put the tables
  2361.        coordinates somewhere in there, you will be able to have a look at
  2362.        what happened and change them later.
  2363.        For  example,  x=100 and y=200 means that the table will be at 200
  2364.        mm down and 100 mm right from the upper left corner.
  2365.        Actually  if you have a width of more than 300 or a height of more
  2366.        than  200  then  it  will automatically be scaled but 200*100 is a
  2367.        good start to have an idea of what coordinates to use.
  2368.      * There  is  also  a visual editor (scratchboard) available, see the
  2369.        explanation at the $cfg['WYSIWYG-PDF'] section.
  2370.      * After  every  table you submitted you will have the possibility to
  2371.        submit more tables
  2372.      * When  you  have entered enough tables Click on your db name in the
  2373.        left frame again
  2374.      * Now,  again at the bottom of the page you should be able to choose
  2375.        "Display PDF schema"
  2376.        For  testing  it  might be useful to show the grid as well, so you
  2377.        can see the coordinates used.
  2378.        Maybe also choose color and submit.
  2379.      * Save  the  file  he  will  offer  you to something like Schema.pdf
  2380.        (Internet Explorer has some bug there which might make it offer it
  2381.        without  an  extension.  Under Windows it is important to have the
  2382.        extension  ".pdf", under other OSes you should be fine just saving
  2383.        the file under the name it offers).
  2384.  
  2385.     [6.9] phpMyAdmin is changing the type of one of my columns!
  2386.  
  2387.    No, it's MySQL that is doing silent column type changing.
  2388.  
  2389.     [6.10] When creating a privilege, what happens with underscores in the
  2390.     database name?
  2391.  
  2392.    If  you  do  not  put  a  backslash  before  the underscore, this is a
  2393.    wildcard  grant,  and the underscore means "any character". So, if the
  2394.    database  name  is  "john_db",  the  user would get rights to john1db,
  2395.    john2db...
  2396.    If  you  put  a  backslash  before  the  underscore, it means that the
  2397.    database name will have a real underscore.
  2398.  
  2399.     [6.11] What is the curious symbol ° in the statistics pages?
  2400.  
  2401.    It means "average".
  2402.  
  2403.     [6.12] I want to understand some Export options.
  2404.  
  2405.    "Complete  inserts" adds the column names on every INSERT command, for
  2406.    better documentation (but resulting file is bigger).
  2407.    "Extended inserts" provides a shorter dump file by using only once the
  2408.    INSERT verb and the table name.
  2409.    "Enclose table and field names with backquotes" ensures that field and
  2410.    table names formed with special characters are protected.
  2411.    "Add AUTO_INCREMENT value" ensures, that AUTO_INCREMENT value (if any)
  2412.    will be included in backup.
  2413.    "Add into comments" includes column comments, relations and MIME types
  2414.    set in the PMA-DB in the dump as SQL comments (/* xxx */).
  2415.  
  2416.     [6.13] I would like to create a database with a dot in its name.
  2417.  
  2418.    This  is  a  bad idea, because in MySQL the syntax "database.table" is
  2419.    the  normal  way  to reference a database and table name. Worse, MySQL
  2420.    will usually let you create a database with a dot, but then you cannot
  2421.    work with it, nor delete it.
  2422.  
  2423.     [6.14] How do I set up the SQL Validator?
  2424.  
  2425.    To  use  it, you need a very recent version of PHP, 4.3.0 recommended,
  2426.    with  XML,  PCRE  and  PEAR  support. On your system command line, run
  2427.    "pear install Net_Socket Net_URL HTTP_Request Mail_Mime Net_DIME SOAP"
  2428.    to get the necessary PEAR modules for usage.
  2429.    On  a  more  recent  pear  version,  I  had problems with the state of
  2430.    Net_DIME    being    beta,   so   this   single   command   "pear   -d
  2431.    preferred_state=beta   install  -a  SOAP"  installed  all  the  needed
  2432.    modules.
  2433.    If  you  use the Validator, you should be aware that any SQL statement
  2434.    you  submit  will  be stored anonymously (database/table/column names,
  2435.    strings,   numbers  replaced  with  generic  values).  The  Mimer  SQL
  2436.    Validator itself, is ⌐ 2001 Upright Database Technology. We utilize it
  2437.    as free SOAP service.
  2438.  
  2439.     [6.15] I want to add a BLOB field and put an index on it, but MySQL says
  2440.     "BLOB column '...' used in key specification without a key length".
  2441.  
  2442.    The  right way to do this, is to create the field without any indexes,
  2443.    then display the table structure and use the "Create an index" dialog.
  2444.    On  this  page,  you will be able to choose your BLOB field, and set a
  2445.    size to the index, which is the condition to create an index on a BLOB
  2446.    field.
  2447.  
  2448.     [6.16] How can I simply move in page with plenty editing fields?
  2449.  
  2450.    You  can  use Ctrl+arrows for moving on most pages with plenty editing
  2451.    fields  (table  structure changes, row editing, etc.) (must be enabled
  2452.    in configuration - see. $cfg['CtrlArrowsMoving']). You can also have a
  2453.    look  at the directive $cfg['DefaultPropDisplay'] ('vertical') and see
  2454.    if this eases up editing for you.
  2455.  
  2456.     [6.17] Transformations: I can't enter my own mimetype! WTF is this feature
  2457.     then useful for?
  2458.  
  2459.    Slow  down  :).  Defining  mimetypes  is  of  no use, if you can't put
  2460.    transformations on them. Otherwise you could just put a comment on the
  2461.    field.  Because  entering  your own mimetype will cause serious syntax
  2462.    checking   issues   and   validation,   this  introduces  a  high-risk
  2463.    false-user-input  situation.  Instead you have to initialize mimetypes
  2464.    using functions or empty mimetype definitions.
  2465.    Plus,  you have a whole overview of available mimetypes. Who knows all
  2466.    those mimetypes by heart so he/she can enter it at will?
  2467.  
  2468.     [6.18] Bookmarks: Where can I store bookmarks? Why can't I see any
  2469.     bookmarks below the query box? What is this variable for?
  2470.  
  2471.    Any  query  you  have executed can be stored as a bookmark on the page
  2472.    where  the  results  are  displayed.  You  will  find a button labeled
  2473.    'Bookmark this query' just at the end of the page.
  2474.    As  soon  as you have stored a bookmark, it is related to the database
  2475.    you  run  the query on. You can now access a bookmark dropdown on each
  2476.    page, the query box appears on for that database.
  2477.    Since  phpMyAdmin  2.5.0  you are also able to store variables for the
  2478.    bookmarks.  Just use the string /*[VARIABLE]*/ anywhere in your query.
  2479.    Everything which is put into the value input box on the query box page
  2480.    will replace the string "/*[VARIABLE]*/" in your stored query. Just be
  2481.    aware  of  that you HAVE to create a valid query, otherwise your query
  2482.    won't be even able to be stored in the database.
  2483.    Also  remember,  that everything else inside the /*[VARIABLE]*/ string
  2484.    for  your query will remain the way it is, but will be stripped of the
  2485.    /**/ chars. So you can use:
  2486.    /*, [VARIABLE] AS myname */
  2487.    which will be expanded to
  2488.    , VARIABLE as myname
  2489.    in  your  query, where VARIABLE is the string you entered in the input
  2490.    box. If an empty string is provided, no replacements are made.
  2491.    A more complex example. Say you have stored this query:
  2492.    SELECT  Name,  Address  FROM  addresses  WHERE  1  /*  AND  Name  LIKE
  2493.    '%[VARIABLE]%' */
  2494.    Say,  you now enter "phpMyAdmin" as the variable for the stored query,
  2495.    the full query will be:
  2496.    SELECT   Name,   Address   FROM   addresses  WHERE  1  AND  Name  LIKE
  2497.    '%phpMyAdmin%'
  2498.    You can use multiple occurences of /*[VARIABLE]*/ in a single query.
  2499.    NOTE  THE  ABSENCE  OF  SPACES inside the "/**/" construct. Any spaces
  2500.    inserted there will be later also inserted as spaces in your query and
  2501.    may  lead  to  unexpected  results  especially when using the variable
  2502.    expansion inside of a "LIKE ''" expression.
  2503.    Your  initial  query  which is going to be stored as a bookmark has to
  2504.    yield  at  least one result row so you can store the bookmark. You may
  2505.    have that to work around using well positioned "/**/" comments.
  2506.  
  2507.     [6.19] How can I create simple LaTeX document to include exported table?
  2508.  
  2509.    You  can  simply include table in your LaTeX documents, minimal sample
  2510.    document  should  look  like  following  one  (assuming you have table
  2511.    exported in file table.tex):
  2512. \documentclass{article} % or any class you want
  2513. \usepackage{longtable}  % for displaying table
  2514. \begin{document}        % start of document
  2515. \include{table}         % including exported table
  2516. \end{document}          % end of document
  2517.  
  2518.     [6.20] In MySQL 4, I see a lot of databases which are not mine, and cannot
  2519.     access them.
  2520.  
  2521.    Upgrading  to  MySQL  4  usually  gives users those global privileges:
  2522.    CREATE TEMPORARY TABLES, SHOW DATABASES, LOCK TABLES. Those privileges
  2523.    also  enables  users  to see all the database names, until you upgrade
  2524.    the  grant  tables  as  described  in  the  MySQL manual. See this bug
  2525.    report.
  2526.    So if your users do not need those privileges, you can remove them and
  2527.    their databases list will shorten.
  2528.  
  2529.     [6.21] In edit/insert mode, how can I see a list of possible values for a
  2530.     field, based on some foreign table?
  2531.  
  2532.    You have to setup appropriate links between the tables, and also setup
  2533.    the  "display field" in the foreign table. See FAQ 6.6 for an example.
  2534.    Then,  if  there  are  200  values  or  less  in  the foreign table, a
  2535.    drop-down  list of values will be available. You will see two lists of
  2536.    values,  the  first list containing the key and the display field, the
  2537.    second  list  containing the display field and the key. The reason for
  2538.    this  is  to be able to type the first letter of either the key or the
  2539.    display field.
  2540.    For  200  values  or  more,  a  distinct window will appear, to browse
  2541.    foreign key values and choose one.
  2542.  
  2543.     [6.22] Bookmarks: Can I execute a default bookmark automatically when
  2544.     entering Browse mode for a table?
  2545.  
  2546.    Yes.  If  a  bookmark  has  the same label as a table name, it will be
  2547.    executed.
  2548.  
  2549.     [6.23] Export: I heard phpMyAdmin can export MS Excel files, how can I
  2550.     enable that?
  2551.  
  2552.    You can either export as CSV suitable for MS Excel, which works out of
  2553.    the  box  or  you  can  try native experimental MS Excel exporter. For
  2554.    enabling  this  you  need  to  set  $cfg['TempDir'] to place where web
  2555.    server  user  can  write (for example './tmp') and install PEAR module
  2556.    Spreadsheet_Excel_Writer  into  php include path. The installation can
  2557.    be done by following command:
  2558.     pear -d preferred_state=beta install -a Spreadsheet_Excel_Writer
  2559.  
  2560.    First  part  of  switches  set we want to install beta version of that
  2561.    module (no stable version available yet) and then we tell pear we want
  2562.    to satisfy dependencies.
  2563.  
  2564.    If  you  are running in PHP safe mode, you will have to set in php.ini
  2565.    the safe_mode_include_dir to the directory where your PEAR modules are
  2566.    located, for example:
  2567.     safe_mode_include_dir = /usr/local/lib/php
  2568.  
  2569.    To create the temporary directory on a UNIX-based system, you can do:
  2570.     cd phpMyAdmin
  2571.     mkdir tmp
  2572.     chmod o+rwx tmp
  2573.  
  2574.   [7. phpMyAdmin project]
  2575.  
  2576.     [7.1] I have found a bug. How do I inform developers?
  2577.  
  2578.    Our Bug Tracker is located at
  2579.    http://sourceforge.net/projects/phpmyadmin/ under the Bugs section.
  2580.    But please first discuss your bug with other users:
  2581.    http://sourceforge.net/projects/phpmyadmin/ (and choose Forums)
  2582.  
  2583.     [7.2] I want to translate the messages to a new language or upgrade an
  2584.     existing language, where do I start?
  2585.  
  2586.    Always  use  the  current CVS version of your language file. For a new
  2587.    language, start from english-iso-8859-1.inc.php. If you don't know how
  2588.    to get the CVS version, please ask one of the developers.
  2589.    Please  note that we try not to use HTML entities like é in the
  2590.    translations,  since  we  define  the right character set in the file.
  2591.    With  HTML entities, the text on JavaScript messages would not display
  2592.    correctly.  However there are some entities that need to be there, for
  2593.    quotes ,non-breakable spaces, ampersands, less than, greater than.
  2594.    You  can  then  put  your  translations, as a zip file to avoid losing
  2595.    special characters, on the sourceforge.net translation tracker.
  2596.    It  would  be  a  good idea to subscribe to the phpmyadmin-translators
  2597.    mailing  list,  because  this  is where we ask for translations of new
  2598.    messages.
  2599.  
  2600.     [7.3] I would like to help out with the development of phpMyAdmin. How
  2601.     should I proceed?
  2602.  
  2603.    The following method is preferred for new developers:
  2604.     1. fetch the current CVS tree over anonymous CVS:
  2605.        cvs
  2606.        -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy
  2607.        admin login
  2608.        [Password: simply press the Enter key]
  2609.        cvs -z3
  2610.        -d:pserver:anonymous@cvs.phpmyadmin.sourceforge.net:/cvsroot/phpmy
  2611.        admin checkout phpMyAdmin
  2612.        [This will create a new sub-directory named phpMyAdmin]
  2613.     2. add your stuff
  2614.     3. put  the  modified  files  (tar'ed  and  gzip'ed) inside the patch
  2615.        tracker of the phpMyAdmin SourceForge account.
  2616.  
  2617.    Write access to the CVS tree is granted only to experienced developers
  2618.    who have already contributed something useful to phpMyAdmin.
  2619.    Also, have a look at the Developers section.
  2620.  
  2621.   [8. Security ]
  2622.  
  2623.     [8.1] Security alert, dated 2003-06-18.
  2624.  
  2625.    Last update of this FAQ: 2003-07-22.
  2626.    The  phpMyAdmin  development  team  received  notice  of this security
  2627.    alert: http://www.securityfocus.com/archive/1/325641.
  2628.    The  team  regrets  that the author did not communicate with us before
  2629.    sending  this  alert. However, here is our current reply to the points
  2630.    mentionned:
  2631.      * "Directory transversal attack"
  2632.        This  problem  had been fixed in version 2.5.0, even if the author
  2633.        reports  the  2.5.2  development  version  as vulnerable, which we
  2634.        could not reproduce.
  2635.      * "Remote local file retrieving"
  2636.        This is a misleading title, as the author tells in his text: "Note
  2637.        that you can't request files ( only dirs )".
  2638.      * "Remote internal directory listing"
  2639.        It  was  possible  to  retrieve the list of phpMyAdmin's directory
  2640.        (which  we  doubt  can cause any damage), but we fixed this in the
  2641.        2.5.2 version.
  2642.      * "XSS and Path disclosures"
  2643.        Most  of  the  XSS  problems have been fixed in version 2.5.0. The
  2644.        rest have been fixed in the 2.5.2 version.
  2645.        We believe that the Path disclosures problems have also been fixed
  2646.        in version 2.5.2.
  2647.      * "Information encoding weakness"
  2648.        We believe that an exploit for this weakness would be difficult to
  2649.        achieve.  However version 2.5.2 now encrypts the password with the
  2650.        well-known blowfish algorithm.
  2651.  
  2652.     [8.2] Security alert, dated 2004-06-29.
  2653.  
  2654.    Last update of this FAQ: 2004-06-30.
  2655.    The  phpMyAdmin  development  team  received  notice  of this security
  2656.    alert:
  2657.    http://securityfocus.com/archive/1/367486/2004-06-26/2004-07-02/0
  2658.    We  would  like  to  put emphasis on the disappointment we feel when a
  2659.    bugreporter  does  not contact the authors of a software first, before
  2660.    posting  any  exploits.  The common way to report this, is to give the
  2661.    developers a reasonable amount of time to respond to an exploit before
  2662.    it is made public.
  2663.    We  acknowledge that phpMyAdmin versions 2.5.1 to 2.5.7 are vulnerable
  2664.    to this problem, if each of the following conditions are met:
  2665.      * The Web server hosting phpMyAdmin is not running in safe mode.
  2666.      * In  config.inc.php,  $cfg['LeftFrameLight']  is  set to FALSE (the
  2667.        default value of this parameter is TRUE).
  2668.      * There  is no firewall blocking requests from the Web server to the
  2669.        attacking host.
  2670.  
  2671.    Version 2.5.7-pl1 was released with a fix for this vulnerability.
  2672.  
  2673. Developers Information
  2674.  
  2675.    phpMyAdmin is Open Source, so you're invited to contribute to it. Many
  2676.    great  features have been written by other people and you too can help
  2677.    to make phpMyAdmin a useful tool.
  2678.  
  2679.    If  you're  planning  to  contribute source, please read the following
  2680.    information:
  2681.      * All       files       include       header.inc.php       (layout),
  2682.        libraries/common.lib.php (common functions) and config.inc.php.
  2683.        Only  configuration  data should go in config.inc.php. Please keep
  2684.        it free from other code.
  2685.        Commonly used functions should be added to
  2686.        libraries/common.lib.php  and  more  specific  ones  may  be added
  2687.        within a library stored into the libraries sub-directory.
  2688.      * Obviously,  you're free to use whatever coding style you want. But
  2689.        please  try to keep your code as simple as possible: beginners are
  2690.        using phpMyAdmin as an example application.
  2691.        As  far  as  possible, we want the scripts to be XHTML1.0 and CSS2
  2692.        compliant  on  one hand, they fit the PEAR coding standards on the
  2693.        other hand. Please pay attention to this.
  2694.      * Please  try  to keep up the file-naming conventions. Table-related
  2695.        stuff   goes   to   tbl_*.php,   db-related   code   to  db_*.php,
  2696.        server-related tools to server_*.php and so on.
  2697.      * Please  don't  use  verbose  strings in your code, instead add the
  2698.        string  (at  least)  to  english-iso-8859-1.inc.php and print() it
  2699.        out.
  2700.      * If  you  want  to  be  really  helpful,  write  an  entry  for the
  2701.        ChangeLog.
  2702.      * The   DBG  extension  (PHP  Debugger  DBG)  is  now  supported  by
  2703.        phpMyAdmin for developers to better debug and profile their code.
  2704.        Please   see  the  $cfg['DBG']*  configuration  options  for  more
  2705.        information.
  2706.        This  is in memoriam of the Space Shuttle Columbia (STS-107) which
  2707.        was lost during its re-entry into Earth's atmosphere and in memory
  2708.        of  the brave men and women who gave their lives for the people of
  2709.        Earth.
  2710.  
  2711. Credits
  2712.  
  2713.  
  2714. phpMyAdmin - Credits
  2715. ====================
  2716.  
  2717. CREDITS, in chronological order
  2718. -------------------------------
  2719.  
  2720. - Tobias Ratschiller <tobias_at_ratschiller.com>
  2721.     * creator of the phpmyadmin project
  2722.     * maintainer from 1998 to summer 2000
  2723.  
  2724. - Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca>
  2725.     * multi-language version
  2726.     * various fixes and improvements
  2727.     * SQL analyser (most of it)
  2728.     * current project maintainer
  2729.  
  2730. - Olivier Mⁿller <om_at_omnis.ch>
  2731.     * started SourceForge phpMyAdmin project in March 2001
  2732.     * sync'ed different existing CVS trees with new features and bugfixes
  2733.     * multi-language improvements, dynamic language selection
  2734.     * current project maintainer
  2735.     * many bugfixes and improvements
  2736.  
  2737. - Lo∩c Chapeaux <lolo_at_phpheaven.net>
  2738.     * rewrote and optimized javascript, DHTML and DOM stuff
  2739.     * rewrote the scripts so they fit the PEAR coding standards and
  2740.       generate XHTML1.0 and CSS2 compliant codes
  2741.     * improved the language detection system
  2742.     * many bugfixes and improvements
  2743.  
  2744. - Robin Johnson <robbat2_at_users.sourceforge.net>
  2745.     * database maintenance controls
  2746.     * table type code
  2747.     * Host authentication IP Allow/Deny
  2748.     * DB-based configuration (Not completed)
  2749.     * SQL parser and pretty-printer
  2750.     * SQL validator
  2751.     * many bugfixes and improvements
  2752.  
  2753. - Armel Fauveau <armel.fauveau_at_globalis-ms.com>
  2754.     * bookmarks feature
  2755.     * multiple dump feature
  2756.     * gzip dump feature
  2757.     * zip dump feature
  2758.  
  2759. - Geert Lund <glund_at_silversoft.dk>
  2760.     * various fixes
  2761.     * moderator of the phpMyAdmin users forum at phpwizard.net
  2762.  
  2763. - Korakot Chaovavanich <korakot_at_iname.com>
  2764.     * "insert as new row" feature
  2765.  
  2766. - Pete Kelly <webmaster_at_trafficg.com>
  2767.     * rewrote and fix dump code
  2768.     * bugfixes
  2769.  
  2770. - Steve Alberty <alberty_at_neptunlabs.de>
  2771.     * rewrote dump code for PHP4
  2772.     * mySQL table statistics
  2773.     * bugfixes
  2774.  
  2775. - Benjamin Gandon <gandon_at_isia.cma.fr>
  2776.     * main author of the version 2.1.0.1
  2777.     * bugfixes
  2778.  
  2779. - Alexander M. Turek <me_at_derrabus.de>
  2780.     * MySQL 4.0 / 4.1 / 5.0 compatibility
  2781.     * abstract database interface (PMA_DBI) with MySQLi support
  2782.     * privileges administration
  2783.     * XML exports
  2784.     * various features and fixes
  2785.     * German language file updates
  2786.  
  2787. - Mike Beck <mike.beck_at_ibmiller.de>
  2788.     * automatic joins in QBE
  2789.     * links column in printview
  2790.     * Relation view
  2791.  
  2792. - Michal Cihar <michal_at_cihar.com>
  2793.     * enhanced index creation/display feature
  2794.     * feature to use a different charset for HTML than for MySQL
  2795.     * improvements of export feature
  2796.     * various features and fixes
  2797.     * Czech language file updates
  2798.  
  2799. - Christophe GeschΘ from the "MySQL Form Generator for PHPMyAdmin"
  2800.   (http://sourceforge.net/projects/phpmysqlformgen/)
  2801.     * suggested the patch for multiple table printviews
  2802.  
  2803. - Garvin Hicking <me_at_supergarv.de>
  2804.     * built the patch for vertical display of table rows
  2805.     * built the Javascript based Query window + SQL history
  2806.     * Improvement of column/db comments
  2807.     * (MIME)-Transformations for columns
  2808.     * Use custom alias names for Databases in left frame
  2809.     * hierarchical/nested table display
  2810.     * PDF-scratchboard for WYSIWYG-distribution of PDF relations
  2811.     * new icon sets
  2812.     * vertical display of column properties page
  2813.     * some bugfixes, features, support, German language additions
  2814.  
  2815. - Yukihiro Kawada <kawada_at_den.fujifilm.co.jp>
  2816.     * japanese kanji encoding conversion feature
  2817.  
  2818. - Piotr Roszatycki <d3xter_at_users.sourceforge.net> and Dan Wilson
  2819.     * the Cookie authentication mode
  2820.  
  2821. - Axel Sander <n8falke_at_users.sourceforge.net>
  2822.     * table relation-links feature
  2823.  
  2824. - Maxime Delorme <delorme.maxime_at_free.fr>
  2825.     * PDF schema output, thanks also to Olivier Plathey for the
  2826.       "FPDF" library (see http://www.fpdf.org/).
  2827.  
  2828. - Olof Edlund <olof.edlund_at_upright.se>
  2829.     * SQL validator server
  2830.  
  2831. - Ivan R. Lanin <ivanlanin_at_users.sourceforge.net>
  2832.     * phpMyAdmin logo (until June 2004)
  2833.  
  2834. - Mike Cochrane <mike_at_graftonhall.co.nz>
  2835.     * blowfish library from the Horde project
  2836.  
  2837. - Marcel Tschopp <ne0x_at_users.sourceforge.net>
  2838.     * mysqli support
  2839.     * many bugfixes and improvements
  2840.  
  2841. - Michael Keck <mkkeck_at_users.sourceforge.net>
  2842.     * redesign for 2.6.0
  2843.     * phpMyAdmin sailboat logo (June 2004)
  2844.  
  2845. And also to the following people who have contributed minor changes,
  2846. enhancements, bugfixes or support for a new language since version 2.1.0:
  2847.  
  2848. Bora Alioglu, Ricardo ?, Sven-Erik Andersen, Alessandro Astarita,
  2849. PΘter Bakondy, Borges Botelho, Olivier Bussier, Neil Darlow,
  2850. Mats Engstrom, Ian Davidson, Laurent Dhima, Kristof Hamann, Thomas KlΣger,
  2851. Lubos Klokner, Martin Marconcini, Girish Nair, David Nordenberg, Andreas Pauley,
  2852. Bernard M. Piller, Laurent Haas, "Sakamoto", Yuval Sarna,
  2853. www.securereality.com.au, Alexis Soulard, Alvar Soome, Siu Sun, Peter Svec,
  2854. Michael Tacelosky, Rachim Tamsjadi, Kositer Uros,
  2855. Luφs V., Martijn W. van der Lee,
  2856. Algis Vainauskas, Daniel Villanueva, Vinay, Ignacio Vazquez-Abrams, Chee Wai,
  2857. Jakub Wilk, Thomas Michael Winningham, Vilius Zigmantas, "Manuzhai".
  2858.  
  2859.  
  2860. Original Credits of Version 2.1.0
  2861. ---------------------------------
  2862.  
  2863.     This work is based on Peter Kuppelwieser's MySQL-Webadmin. It was his idea
  2864.     to create a web-based interface to MySQL using PHP3. Although I have not
  2865.     used any of his source-code, there are some concepts I've borrowed from
  2866.     him. phpMyAdmin was created because Peter told me he wasn't going to
  2867.     further develop his (great) tool.
  2868.     Thanks go to
  2869.     - Amalesh Kempf <ak-lsml_at_living-source.com> who contributed the
  2870.       code for the check when dropping a table or database. He also suggested
  2871.       that you should be able to specify the primary key on tbl_create.php3. To
  2872.       version 1.1.1 he contributed the ldi_*.php3-set (Import text-files) as
  2873.       well as a bug-report. Plus many smaller improvements.
  2874.     - Jan Legenhausen <jan_at_nrw.net>: He made many of the changes that
  2875.       were introduced in 1.3.0 (including quite significant ones like the
  2876.       authentication). For 1.4.1 he enhanced the table-dump feature. Plus
  2877.       bug-fixes and help.
  2878.     - Marc Delisle <DelislMa_at_CollegeSherbrooke.qc.ca> made phpMyAdmin
  2879.       language-independent by outsourcing the strings to a separate file. He
  2880.       also contributed the French translation.
  2881.     - Alexandr Bravo <abravo_at_hq.admiral.ru> who contributed
  2882.       tbl_select.php3, a feature to display only some fields from a table.
  2883.     - Chris Jackson <chrisj_at_ctel.net> added support for MySQL
  2884.       functions in tbl_change.php3. He also added the
  2885.       "Query by Example" feature in 2.0.
  2886.     - Dave Walton <walton_at_nordicdms.com> added support for multiple
  2887.       servers and is a regular contributor for bug-fixes.
  2888.     - Gabriel Ash <ga244_at_is8.nyu.edu> contributed the random access
  2889.       features for 2.0.6.
  2890.     The following people have contributed minor changes, enhancements, bugfixes
  2891.     or support for a new language:
  2892.     Jim Kraai, Jordi Bruguera, Miquel Obrador, Geert Lund, Thomas Kleemann,
  2893.     Alexander Leidinger, Kiko Albiol, Daniel C. Chao, Pavel Piankov,
  2894.     Sascha Kettler, Joe Pruett, Renato Lins, Mark Kronsbein, Jannis Hermanns,
  2895.     G. Wieggers.
  2896.  
  2897.     And thanks to everyone else who sent me email with suggestions, bug-reports
  2898.     and or just some feedback.
  2899.  
  2900.                                         Valid XHTML 1.0!      Valid CSS! 
  2901.